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DOCUMENTATION RELEASE NOTE 


Thank you for using RealOne Player! This guide explains RealOne Player clip 
types, such as RealVideo and RealText, and covers the use of the SMIL 2.0 
standard, along with the RealNetworks extensions to SMIL 2.0. Although 
RealOne Player currently supports most SMIL 2.0 features, some additional 
features will be added at a later date, and will be made available automatically 
through RealOne Player’s autoupdate feature. The following sections describe 
known issues with content production in this release of RealOne Player. 


Tip: See Chapter 1 for summaries of new SMIL 2.0 features, as 
well as for information about additional changes to this guide 
from Release 8. 


Latest Additions 


The following sections note significant additions to this guide following its 
initial publication. 


July 2002 
+ Updated the RealAudio chapter with information about the RealAudio 
surround sound codecs. See “Surround Sound Codecs” on page 64. 


+ Updated the RealVideo chapter to cover RealVideo 9. See “RealVideo 9 
Codec” on page 79. 


Known Issues 


You may find discrepancies between the instructions in this guide and 
RealOne Player performance. Known issues include the following: 


- Using a Ram file in a SMIL file, which is described in “Using a Ram File as 
a Source” on page 213, is not fully functional. 
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- Using a SMIL file in a SMIL file, which is described in “Using a SMIL File 
as a Source” on page 214, is not fully functional. 


+ Secondary windows, which are described in the section “Secondary Media 
Playback Windows” on page 269, are currently plain windows that do not 
include the standard RealOne Player skin. 


+ The <area/> tag’s nohref attribute, described in “Leaving Out a URL 
Reference for Hot Spots” on page 368, does not function. 


« Hyperlink access keys, which are described in “Opening a Link ona 
Keystroke” on page 368, are not functional. 


- Targeting an HTML frame through SMIL, as described in “Targeting a 
Frame or Named Window” on page 375, is not functional. 


+ Contrary to the information in “Replacing the Source Presentation” on 
page 377, a source clip stops, rather than pauses, when another clip 
replaces it in the media playback pane. 


+ Linking to part of a SMIL file, as described in “Linking to a SMIL 
Fragment” on page 381, is not functional. 


+ Modifying clip sound levels when a link is traversed is not yet working. 
This feature is described in “Adjusting Audio Volumes in Linked 
Presentations” on page 382. 


- Push wipe transitions, described in “Fade, Push, and Slide Transition 
Effects” on page 405, are not yet functional. 


- Using a <switch> group to test the viewer’s computer hardware and 
software, which is described in “Switching Based on the Viewer’s 
Computer” on page 449, is not fully functional. 


+ Prefetching, which is described in Chapter 19, is not functional. 


Undocumented Features 


The following aspects of RealOne Player functionality have not yet been 
documented, and in most cases are not fully functional: 


+ Support for media markers. The section “Using Media Markers” on page 
352 is a placeholder for this information. 


+ Support for wallclock timing. The section “Coordinating Clips to an 
External Clock” on page 352 is a placeholder for this information. 
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+ The min and max timing attributes. The section “Setting Minimum and 
Maximum Times” on page 320 is a placeholder for this information. 


- Time manipulations for animations. The section “Manipulating 
Animation Timing” on page 437 is a placeholder for this information. 


« The skip-content attribute. 


- The <metadata> tag. 


Netscape Navigator 6 Issues 
There are two issues currently associated with using Netscape Navigator 6: 


- If you embed a presentation in a Web page as described in Chapter 20, the 
path to the .rpm file cannot contain spaces or even escape codes for spaces 
(%20). This causes Navigator 6 to search for a missing plug-in. 


+ If you browse the HTML version of this guide with Navigator 6, you may 
not be able to play the linked sample files. If this occurs, you can open the 
sample files directly from the samples folder. You can also use Navigator 
4.7 or Microsoft Internet Explorer (version 5.5 or higher recommended) to 
browse the guide. 


Note: This linking problem affects only local, relative URLs to 
clips played in RealOne Player. It does not affect streamed 
presentations in which the viewer launches the presentation 
from a Web page rendered in Navigator 6. 


For More Information: The section “How to Download This 
Guide to Your Computer” on page 12 explains how to get a 
local copy of the HTML guide that includes sample files. 
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INTRODUCTION 


RealOne Player™ gives you the power to deliver compelling 
multimedia presentations over a network. This production guide 
will help you produce any multimedia presentation, whether it is a 


simple video on your home page or a multimedia extravaganza. 


Tip: To experience the many possibilities of streaming media, 
download RealOne Player from http://www.real.com, and 
then visit http://realguide.real.com. 


What is Helix? 


Helix” from RealNetworks is a universal digital media delivery platform. With 
industry-leading performance, integrated content distribution, advertising, 
user authentication, Web services support, and native delivery of RealMedia, 
Windows Media, QuickTime, and MPEG-4, Helix from RealNetworks is a 
robust digital media foundation that meets the needs of enterprises and 


networking service providers. 


What This Guide Covers 


This production guide tells you how to create a RealOne Player presentation. 
Although it provides many tips for producing streaming media, the more you 
know about producing audio, video, and graphics in general, the faster you 
will be able to create a great streaming presentation. Topics in this guide fall 


into four general areas: 
. Planning a Presentation 


Before you launch into streaming media production, you need to consider 
several issues carefully. What is your target bandwidth? What types of 
clips will you use? How will your presentation timeline progress? 
Addressing these issues is critical for producing a successful presentation. 
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To learn the basics, start with “Chapter 2: Presentation Planning” 
beginning on page 27. 


Producing Clips 


RealOne Player plays a core set of clip types: RealAudio®, RealVideo®, 
Flash, RealText™, and RealPix™. You can stream just a single clip, or 
combine various clips into a complex presentation. “Part II: Producing 
Clips” beginning on page 57 explains these clip types. 


Note: This guide does not explain how to use encoding tools 
such as Helix Producer™. For specific information about using 
a particular tool, refer to the tool’s user’s guide or online help. 


Writing SMIL 2.0 


To unify multiple clips into a single presentation, you use Synchronized 
Multimedia Integration Language (SMIL), a mark-up language that you 
can write with any text editor. If you’ve written HTML, you'll find it easy 
to pick up SMIL. To get started, turn to “Part IV: Learning SMIL” 
beginning on page 189. 

Delivering a Presentation 

Once you finish production, you’ll want to show off your work! “Part VIII: 
Streaming Your Presentations” beginning on page 477 explains how to 


stream your presentation from Helix Universal Server or a Web server, as 
well as how to embed it in a Web page. 


Because this guide concerns streaming media production and the RealOne 


Player core clip types, it does not cover the following topics: 


running Helix Universal Server and broadcasting on the Internet 


Helix Universal Server is the streaming engine that drives streaming media 
across a network. You can learn more about Helix Universal Server from 
this Web address: 


http://www.realnetworks.com/products/media_delivery.html 
using the RealOne Player interface 


Available for free download from http://www.real.com, RealOne Player 
includes a Help menu with entries that explain its many features. 


using RealOne Player Javascript and VBScript methods 


Introduction 


To learn how to use Javascript or VBScript in the RealOne Player 
environment, see RealOne Player Scripting Guide, available for download 
from the following Web page: 


http://service.real.com/help/library/encoders.html 


digital rights management for audio and video clips 


RealNetworks provides a Media Commerce Suite that allows you to 
protect copyrights for valuable media assets. You can learn more about 
this suite from the following Web page: 


http://www.realnetworks.com/products/commerce/index.html 


encoding video and audio files for streaming 


Helix Producer is the tool you use to convert audio and video files into 
streaming RealAudio and RealVideo clips. You can get Helix Producer 
from this Web page: 


http://www.realnetworks.com/products/producer/index.html 


producing audio and video clips in formats other than RealAudio and 
RealVideo. 


RealOne Player can play many audio and video formats in addition to 
RealAudio and RealVideo. For more information about the tools you can 
use to produce media in these additional streaming formats, visit the 
following Web page: 


http://www.realnetworks.com/products/index.html 
Tip: Although this guide does not explain how to produce 
audio and video in formats such as MPEG, many of the tips 


given in Chapter 3 and Chapter 4 apply to audio and video 
production in general, regardless of the streaming format. 


How this Guide Is Organized 


Part I: Getting Started with Streaming Media 


Whether you are new to streaming media, or an old hand, be sure to read the 
following chapters. 
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Chapter 1: New Features 
If youw’re familiar with previous versions of RealNetworks software, this 
chapter will give you a quick update on the many changes in this version. 


Chapter 2: Presentation Planning 

If you are new to streaming media, this chapter walks you through the steps 
involved in putting together a RealOne Player presentation, explaining 
bandwidth and timeline issues. 


Part Il: Producing Clips 


The clip is the basic unit of a streaming media presentation. The following 
chapters explain production issues for core RealOne Player clip types. 


Chapter 3: Audio Production 
This chapter gives you the background you need to create a RealAudio clip. It 
then provides pointers on capturing and digitizing high-quality audio clips. 


Chapter 4: Video Production 
Read this chapter to learn how to capture high-quality video content and 
optimize it for conversion to streaming RealVideo clips. 


Chapter 5: Flash Animation 
Using Macromedia’s Flash, you can produce dazzling animated presentations. 
This chapter explains how to stream Flash clips to RealOne Player. 


Part III: Writing Markup 


Using RealNetworks markup languages, you can create additional types of 
streaming clips. 


Chapter 6: RealText Markup 

With RealText, you can create text that displays at different times in your 
presentation. This is a great way to provide video credits and subtitles, for 
example. 


Chapter 7: RealPix Markup 

RealPix allows you to coordinate still images into streaming slideshows. When 
accompanied by an audio soundtrack, RealPix presentations make a great 
alternative to video. 
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Part IV: Learning SMIL 


SMIL is the heart of streaming media, letting you pull together simple or 
highly complex presentations. Read the following chapters to get started. 


Chapter 8: SMIL Basics 

After you create your multimedia clips, you write a SMIL file that pulls the 
entire presentation together. This chapter explains the basic structure and 
syntax of a SMIL file. 


Chapter 9: Clip Source Tags 
This chapter explains how to add clips to a SMIL presentation, explaining the 
various streaming and download protocols, such as RTSP and HTTP. 


Part V: Organizing a Presentation 


When you stream multiple clips, you use SMIL to group your clips and lay out 
the presentation. The following chapters explain how to organize your media. 


Chapter 10: Presentation Information 
This chapter demonstrates how to add presentation information to a SMIL 
file to enhance the playback experience and aid viewer accessibility. 


Chapter 11: Groups 
This chapter shows you how to make clips play together or in a sequence. 
Creating groups is the most basic way to set up a SMIL timeline. 


Chapter 12: Layout 
When clips play in parallel, you create a layout as described in this chapter. 
You can even make new clips pop up in new windows. 


Part VI: Timing and Linking Clips 
Unlike a static Web page, streaming media flows. Timing is a key aspect of 


SMIL, and the following chapters explain how to create a timeline, as well as 
how to link to other resources. 


Chapter 13: Basic Timing 

The SMIL timing commands give you a powerful means to coordinate clip 
playback. Read this chapter to learn the basics of how to use SMIL to modify a 
presentation’s timeline. 
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Chapter 14: Advanced Timing 
Once you’ve mastered the basics of SMIL timing as described in Chapter 13, 
yow’re ready to learn about the advanced SMIL timing features described here. 


Chapter 15: Hyperlinks 
Refer to this chapter to learn how SMIL’s hyperlinking capabilities let you 
launch new clips or presentations. 


Part VII: Mastering Advanced Features 


SMIL is a powerful language that lets you add special effects to your 
presentation. You can also use SMIL to manage bandwidth, and stream 
different clips to different viewers. 


Chapter 16: Transition Effects 
SMIL provides over a hundred special effects you can use when a clip starts or 
stops playback. This chapter shows you how to create eye-catching transitions. 


Chapter 17: Animations 
Read this chapter to learn how to use SMIL animations (not to be confused 
with Flash animation) to create special effects while clips play. 


Chapter 18: Switching 

SMIL lets you stream different presentations based on viewer criteria, such as 
available bandwidth or language preference. Read this chapter to learn about 
SMIL’s switching capabilities. 


Chapter 19: Prefetching 
Prefetching is a powerful feature that lets you download clip data before a clip 
plays. This can help prevent presentation rebuffering. 


Part VIII: Streaming Your Presentations 


When you finish production, you’re ready to make your presentation available 
for viewing as described in the following chapters. 


Chapter 20: Web Page Embedding 
If you want to integrate your presentation seamlessly into your Web page, 
follow the instructions in this chapter. 
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Chapter 21: Presentation Delivery 

This chapter gives instructions for moving your streaming clips to Helix 
Universal Server and linking your Web page to them through a Ram file. It 
also explains how to use a Web server to deliver simple presentations. 


Part IX: Basic Information 


The following appendixes gather useful information that will help you 
whether you're a novice or a professional. 


Appendix A: Basic Questions 

If you are new to streaming media, this appendix answers basic production 
y g , PP Pp 

questions and points you to additional resources on the Internet. 


Appendix B: Production Tasks 
Consult this appendix when you want to carry out a specific production task, 
but don’t know where to find the answer in this guide. 


Appendix C: Color Values 
This appendix covers the types of color values that you can use with SMIL, 
RealText, and RealPix attributes. 


Part X: Syntax Summaries 


The remaining appendixes summarize the markup languages used with 
RealOne Player. 


Appendix D: SMIL Tag Summary 
Once you understand SMIL, use this appendix as a reference for SMIL 2.0 tag 
and attribute values. 


Appendix E: RealText Tag Summary 
This appendix summarizes RealText markup, which is explained in Chapter 6. 


Appendix F: RealPix Tag Summary 
Refer to this appendix for quick information on RealPix markup, which is 
explained in Chapter 7. 


Appendix G: Ram File Summary 
Use this appendix as a quick reference to the Ram file parameters described in 
Chapter 21. 
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Appendix H: File Type Summary 
This appendix provides a quick reference for common file types used in 
RealOne Player streaming. 


Appendix |: Language Codes 
If you create streaming clips in different languages as described in Chapter 18, 
you use these codes in your SMIL file to indicate the language choices. 


How to Download This Guide to Your Computer 


RealNetworks makes this guide available in the following formats for 
download to your computer: 


+ The HTML+Javascript version is available as a single, zipped archive that 
includes utilities and samples that you can play in RealOne Player. It is 
highly recommended for persons who want to learn SMIL markup. You 
can read this version with Netscape Navigator or Microsoft Internet 
Explorer. 


+ The HTML Help version is available as a single .chm file for Windows 98 
and later operating systems. It is identical to the HTML+Javascript 
version, except that it does not contain any sample files. The HTML Help 
version is smaller in size than the HTML+Javascript version, and it 
includes a search function. 


- An Adobe Acrobat (PDF) version includes page numbers in cross- 
references, making it more useful than the HTML versions when printed. 
You can download the free Acrobat viewer from Adobe’s Web site at 


http://www.adobe.com/products/acrobat/readstep.html. 


All of the online versions of this guide are available for individual download 
from RealNetworks’ Technical Support Web site at: 


http://service.real.com/help/library/encoders.html 


Introduction 


Conventions Used in this Guide 


The following table explains the typographical conventions used in this 
production guide. 


Notational Conventions 


Convention Meaning 

emphasis Bold text is used for in-line headings, user-interface 
elements, URLs, and e-mail addresses. 

terminology Italic text is used for technical terms being introduced, 
and to lend emphasis to generic English words or 
phrases. 

syntax This font is used for fragments or complete lines of 


programming syntax (markup). 


syntax emphasis | Bold syntax character formatting is used for program 
names, and to emphasize specific syntax elements. 


variables Italic syntax character formatting denotes variables 
within fragments or complete lines of syntax. 


[options] Square brackets indicate values that you may or may not 
need to use. As a rule, when you use these optional values, 
you do not include the brackets themselves. 


choice 1|choice 2 | Vertical lines, or “pipes,” separate values you can choose 
between. 


Ellipses indicate nonessential information omitted from 
examples. 


Additional Resources 


Most RealNetworks® manuals are available in both PDF and HTML formats 
from the RealNetworks documentation library. The library’s main page is at 
http://service.real.com/help/library/index.html. In addition to this 


production guide, you may need the following resources: 
+ Introduction to Streaming Media 


Start with this guide if you are new to streaming media. Written for the 
beginning user, it explains how to put together a basic presentation using 
different production techniques. Download this guide from 
http://service.real.com/help/library/encoders.html. 
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+ RealOne Player Scripting Guide 


Available at http://service.real.com/help/library/encoders.html, this 
guide explains how to use JavaScript or VBScript within the RealOne 
Player three-pane environment, or for media embedded in a Web page. 


¢ Helix Universal Server Administration Guide 


The basic reference for the Helix Universal Server administrator, this 
guide explains how to set up, configure, and run Helix Universal Server to 
stream multimedia. You need this guide only if you are running Helix 
Universal Server yourself. It is available at 
http://service.real.com/help/library/ 

servers.html. 


+ Software Development Kits (SDKs) 


RealNetworks offers SDKs for Helix Universal Server and Helix Producer. 
Designed for programmers, SDKs help you to integrate applications with 
RealOne Player, or create new plug-ins for Helix Universal Server and 
RealOne Player. Get the Helix Universal Server SDK at this site: 


http://proforma.real.com/rnforms/resources/server/realsystemsdk/ 
index.html 


The Helix Producer SDK is available here: 


http://proforma.real.com/rnforms/resources/producer/ 
producersdk/index.html 


Technical Support 
To reach RealNetworks’ Technical Support, please fill out the form at: 
- http://forms.real.com/service/techsupport/contact.html 


The information you provide in this form will help Technical Support 
personnel respond promptly. 


PART 


GETTING STARTED WITH STREAMING MEDIA 


Whether you are new to streaming media, or an old hand, this 
section will get you rolling with the latest streaming technology. 
Chapter 1 describes the many new features of RealOne Player, 

while Chapter 2 explains the basics of putting together a 


streaming presentation. 


CHAPTER 


T 


NEW FEATURES 


RealOne Player gives you more possibilities for creating Web-based 
multimedia than ever. If you’re familiar with previous versions of 
RealPlayer, this chapter gives you a quick look at the many changes 


to streaming media production in RealOne Player. 


RealOne Player Introduced 


The successor to RealPlayer 8, RealOne Player provides the most advanced 
media playback possibilities available, combining streaming media, digital 
downloads, and Web browsing. For more on RealOne Player, see “Step 2: Learn 
the RealOne Player Interface” on page 29. 


SMIL 2.0 Support 


RealOne Player supports SMIL 2.0, which adds many new features to SMIL 
1.0. RealOne Player is backwards-compatible with SMIL 1.0, so it can play any 
existing SMIL presentation. RealPlayer G2, RealPlayer 7, and RealPlayer 8 
cannot play SMIL 2.0 presentations. These versions of RealPlayer autoupdate 
to RealOne Player before playing a SMIL 2.0 file. See Chapter 8 for basic SMIL 
2.0 information. 


Note: This guide describes SMIL 2.0 only. For SMIL 1.0 
information, see RealSystem iQ Production Guide for Release 8. 
That guide is available in HTML and PDF formats at 
http://service.real.com/help/library/encoders.html. 


SMIL 2.0 Files Require an XML Namespace 


A simple <smil> tag designates a SMIL 1.0 file. To write a SMIL 2.0 file, you 
need to include an XML namespace like this: 


<smil xmlns=“http://www.w3.org/2001/SMIL20/Language”> 
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For More Information: See “The SMIL 2.0 Tag and Namespace” 
on page 198 for more information. 


SMIL 2.0 Attributes Use “Camel Case” 


In SMIL 2.0, most attributes and predefined values that have multiple words 
now use camel case, in which all words are compounded and words following 
to the first word are capitalized. For example, the system-bitrate attribute in 
SMIL 1.0 becomes systemBitrate in SMIL 2.0. For more information, see “Tags, 
Attributes, and Values” on page 200. 


New and Updated SMIL Resources 


In addition to the chapters that describe SMIL 2.0 features, this guide adds or 
updates several resources that will help you with creating presentations: 


+ For information on updating SMIL 1.0 syntax to SMIL 2.0 standards, see 
“Updating SMIL 1.0 Files to SMIL 2.0” on page 207. 


- Appendix B addresses specific production questions by referring you to 
the appropriate section in this guide. 


- Appendix C explains the types of color values that you can specify. 


- Appendix D provides a quick reference for SMIL tags and attributes that 
will help you once you’re familiar with SMIL markup. 


+ Download the zipped HTML version of this production guide as 
described in “How to Download This Guide to Your Computer” on page 
12. Then choose Sample Files from the Go To menu to display links to 
SMIL files that you can play in RealOne Player. 


Introductory Production Guide 


Beginning users, or those looking to create simple presentations, can start 
with Introduction to Streaming Media, which is available for download at 
http://service.real.com/help/library/index.html. That guide provides a 
simplified, streamlined introduction to SMIL 2.0 and Ram files. 


New Clip Tag Attributes 


Chapter 9 explains the changes to SMIL clip source tags, such as <video/> tags. 
SMIL 2.0 introduces several new clip attributes, as the following sections 
explain. 
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Color Attributes 


As described in “Modifying Clip Colors” on page 222, RealOne Player 
supports new color attributes that allow you to make the following 
transparent or semi-transparent: 


+ any color or range of colors in a clip 
+ all colors in a clip 


+ aclip’s background color 


Image Streaming Rates 


SMIL 2.0 provides a new method for setting streaming rates for static clips 
such as images. See “Setting a Clip’s Streaming Speed” on page 210. 


Text Handling 


In addition to support for RealText clips (.rt), RealOne Player and SMIL 2.0 
can display plain text files (.txt), and support the inclusion of text directly 
within the SMIL markup. For more information, see “Adding Text to a SMIL 
Presentation” on page 227. 


Descriptive Metatags 


In addition to title, author, copyright, and abstract attributes, clip source tags 
can have alt, longdesc, and readIndex attributes. These attributes allow assistive 
devices to read clip information for visually impaired viewers. For more 
information, see “Adding Accessibility Information” on page 241. 


Colored Objects with the <brush/> Tag 


The <brush/> tag functions just like a clip source tag such as <video/>. It does 
not link to a media clip, however. Instead, it defines a color that displays in a 
region. For more information, see “Creating a Brush Object” on page 213. 


Expanded Grouping Possibilities 


Chapter 11 explains <seq> and <par> groups, which have changed little from 
SMIL 1.0. It also covers the <excl> tag, which is new in SMIL 2.0. 


19 


RealNetworks Production Guide 


Sequences Act Like a Single Presentation 


In SMIL 2.0, a simple sequence of clips defined in a <seq> group acts like a 
single presentation instead of a series of separate presentations. See “Playing 
Clips in Sequence” on page 247 for more information. 


New <excl> Groups 


The exclusive group is a powerful feature that you can use to add interactivity 
to a presentation. The new <excl> tag creates an exclusive group, in which only 
one clip can play at a time. Unlike with a <seq> group, though, you can specify 
the order in which the <excl> group members play, have them interrupt each 
other, and select them based on any criteria, including mouse clicks. See 
“Creating an Exclusive Group” on page 259 for more information. 


Synchronizing Parallel Elements 


The section “Synchronizing Playback in Parallel Groups” on page 250 explains 
how to control which clips in parallel groups stay synchronized if bandwidth 

drops. This advanced feature also lets you create an independent timeline for a 
clip to make it act like a broadcast. In this case, viewers cannot rewind or fast- 


forward through the clip. 


Enhanced Layout Choices 
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Chapter 12 explains how to lay out clips in RealOne Player using SMIL 2.0 
layout tags and attributes, which provide many new layout possibilities. The 
following sections describe the principal new features of SMIL 2.0 layout. 


Secondary Pop-Up Windows 


You can now use <topLayout> tags to create secondary media playback 
windows that pop up during a presentation. This window is useful for playing 
supplemental clips, or clips that do not fit the main media playback pane’s 
layout. See “Secondary Media Playback Windows” on page 269 for more 
information. 


Subregions 


The section “Subregions” on page 268 describes how to create regions within 
regions. Creating a subregion is useful if you want to associate a smaller 
region with a larger region so that the smaller region changes position 
automatically if you reposition the larger region. 
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Region Size and Position Attributes 


To set a region’s size and position within a window, you can now use bottom 
and right attributes, as well as height, width, left, and top. You can also use any 
combination of these attributes to create a region, giving you more ways to 
define layouts. See “Defining Region Sizes and Positions” on page 281 for 
more information. 


Registration Points 


With registration points, which are described in the “Clip Position and Fit” on 
page 271, you can easily position clips within large regions. You can use a 
registration point to center clips, for example, or align them to a region’s 
lower-right corner. 


Region Transparency 


RealOne Player supports true region transparency, meaning that clips behind 
transparent areas of another clip are visible. See “Transparency in Regions and 
Clips” on page 291 for more information. 


Backgrounds Can Appear Only When Clips Play 


You can now set region background colors to appear only when a clip plays in 
the region. Previously, all regions and backgrounds appeared automatically at 
the start of the presentation. See “Setting When Background Colors Appear” 

on page 290 for more information. 


More Timing Possibilities 


SMIL 2.0 provides many new ways to construct presentation timelines. 
Chapter 13 and Chapter 14 explain basic and advanced timing attributes, 
respectively. 


New Element Repeat Attributes 


The new repeatCount and repeatDur attributes replace the SMIL 1.0 repeat 
attribute. The new attributes let you specify a total number of repetitions, or 
the total length of the repeating cycle, respectively. See “Repeating an 
Element” on page 323 for details. 
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Additional fill Values 


The fill attribute includes new values (auto, default, hold, and transition) that let 
you specify additional fill behaviors. A new fillDefault attribute lets you set the 
fill behavior for entire groups. For more information, see “Setting a Fill” on 
page 327, as well as “Specifying a Default Fill” on page 334. 


Advanced Timing Values 


See Chapter 14 for information on advanced SMIL timing values. These values 
work with the begin and end attributes to start and stop elements when certain 
events occur, such as when the viewer clicks a clip or presses a keyboard key. 


New Linking Attributes 
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Chapter 15 covers hyperlinking, explaining how to link a SMIL presentation 
to a Web page or another SMIL presentation. 


The <area/> Tag Replaces <anchor/> 


The SMIL 2.0 <area/> tag replaces the SMIL 1.0 <anchor/> tag. The <area/> tag 
lets you turn an entire clip into a link, as well as create hot spots (image maps) 
over a clip. You can now create hot spots as rectangles, circles, and polygons. 
See “Using the <area/> Tag” on page 360. 


New Ways to Open Links 


SMIL 2.0 includes new ways to specify when a link opens. You can define a 
keyboard key that the viewer can press to open a link, for instance, or you can 
make links open automatically at any point in the presentation. See “Defining 
Basic Hyperlink Properties” on page 367 for more information. 


Ability to Control RealOne Player State 


The SMIL attribute sourcePlaystate in a link controls RealOne Player’s state 
when a link is clicked. You can make the RealOne Player presentation pause, 
stop, or continue playing when the link opens. For more on sourcePlaystate, see 
“Linking to HTML Pages” on page 371 or “Linking to Streaming Media” on 
page 377. 


RealOne Player Browsing Windows 


RealOne Player on Windows includes its own browsing windows, which allow 
you to display HTML pages within the RealOne Player environment, as well as 
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in the viewer’s default Web browser. The RealOne Player related info window, 
which appears to the right of the media playback window, can display HTML 
pages that supplement the streaming presentation. For more information, see 
“Linking to HTML Pages” on page 371. 


Clip Transition Effects 


Chapter 16 explains how to define clip transition effects, which are special 
effects that display when a clip starts or stops. You can use transition effects to 
crossfade sequential clips, for example, or introduce a new clip with a slide, a 
wipe, or over a hundred other effects found in professional video production. 


SMIL Animations 


Chapter 17 explains how to create SMIL animations, which are special effects 
that display as a clip plays. You can use SMIL animations to shrink a clip, 
move it around the screen, alter its background color, and change its volume 
level, for example. Unlike Flash animation, SMIL animations are not clips. 
Rather, they are instructions that tell RealOne Player how to alter the display 
of other clips, whether videos, still images, audio clips, or so on. 


Powerful Content Control Capabilities 


SMIL 2.0 has sophisticated content control features that allow the advanced 
SMIL author to tailor presentations for different audiences and network 
conditions. 


Additional Switching Test Attributes 


SMIL 2.0 includes several new test attributes that you can use in <switch> 
groups. These attributes let you display alternative presentations for different 
monitor sizes or operating systems, for example. For a list of test attributes, 
see “Available Test Attributes” on page 442. 


Inline Switching 


You can add any switching test attribute directly to a clip source tag or a group 
tag without using a <switch> tag. RealOne Player then plays the clip or group 
only if it satisfies the attribute value. Although not recommended for all 
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situations in which switching is required, inline switching can be useful in 
many cases. For more information, see “Using Inline Switching” on page 441. 


Prefetching Clip Data 


With <prefetch/> tags, you can download clip data before clips play. This 
feature gives you a powerful way to manage your presentation’s streaming 
bandwidth. See Chapter 19 for information on prefetching. 


Additions and Deletions to this Guide 
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In addition to describing new features of RealOne Player, this manual includes 
several organizational changes from previous versions. 


RealText and RealPix Markup Described 


Chapter 6 and Chapter 7 of this guide provide instructions for writing 
RealText and RealPix markup, respectively. The RealText Authoring Guide and 
RealPix Authoring Guide, which cover RealText and RealPix through Release 8, 
are obsolete, though still available for download from the RealNetworks 
Technical Support Web site. 


RealOne Player does not include significant updates to RealText and RealPix, 
and the RealText and RealPix clips you create according to instructions in this 
guide will be backwards-compatible with earlier versions of RealPlayer. When 
used with RealOne Player and SMIL 2.0, however, these RealText and RealPix 
offer some significant improvements. For example, you can now use SMIL 2.0 
to turn a RealText clip’s background transparent or semi-transparent. This is 
useful for overlaying a video with subtitles, for example. 


For More Information: See “Creating a Transparent Window 
Background” on page 117. 


No Chapters on Advertising and Broadcasting 


This guide no longer contains chapters that cover the Advertising Application 
and broadcasting. Information about using SMIL with the Advertising 
Application is available separately. For information about broadcasting media, 
see Helix Producer User’s Guide and Helix Universal Server Administration Guide. 
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Authoring Kit Discontinued 


The Authoring Kit, a zipped bundle of content production guides and 
utilities, has been discontinued. Production guides are available as separate 
downloads at the following Web page: 


http://service.real.com/help/library/encoders.html 


Note: The RealPix and Flash utilities formerly included in the 
Authoring Kit are now available in the utilities folder of the 
zipped HTML bundle of this production guide. 
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CHAPTER 


2 


PRESENTATION PLANNING 


A streaming presentation may be as basic as a single clip, or as 
complex as dozens of clips and HTML pages coordinated to display 
at different times. No matter how simple or complicated your 
presentation, you’ll need to plan your media production so you can 
work effectively and reach your target audience. This chapter 
explains the basics of how to put streaming media presentations 
together. If you are not yet familiar with streaming media and 


RealOne Player, see also Appendix A beginning on page 531. 


Tip: For a streamlined approach to media production, 
download Introduction to Streaming Media from 
http://service.real.com/help/library/encoders.html. 


Step 1: Decide How to Deliver Clips 


The first step in creating a streaming presentation is to consider the last step: 
how will you deliver your clips to other people? How you plan to stream your 
clips can greatly affect your media production. 


Helix Universal Server Streaming 


Helix Universal Server is the preferred host for RealOne Player presentations. 
Designed specifically to stream multimedia over networks, Helix Universal 
Server keeps multiple clips synchronized and uses many advanced features to 
ensure that clips stream smoothly, even under adverse network conditions. A 
Helix Universal Server administrator sets up and runs each Helix Universal 
Server. If you will not be running Helix Universal Server yourself, check the 
following with your Helix Universal Server administrator: 
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1. What server version is available? 


To deliver the clips described in this guide, you'll need Helix Universal 
Server or RealSystem Server 8, rather than any of the earlier versions. 
Make sure that your Helix Universal Server can deliver all the clips that 
you plan to develop. 


2. How many streams can Helix Universal Server deliver? 


Each Helix Universal Server has a maximum number of media streams it 
can send out at once. A Helix Universal Server with a maximum of 500 
streams, for example, can stream video to 500 viewers simultaneously. 
Make sure that the Helix Universal Server you plan to use has adequate 
capacity for your needs. 


3. Are there any bandwidth constraints? 


The Helix Universal Server computer may lack the outgoing bandwidth to 
deliver a lot of high-speed clips simultaneously. If you plan to develop 
high-bandwidth presentations, confer with the Helix Universal Server 
administrator about bandwidth limitations. 


4. Where will your clips reside? 


Your clips typically reside on Helix Universal Server, whereas your Web 
pages are on a Web server. You'll need to know the URLs for your clips on 
Helix Universal Server so that you can set up your Web page hyperlinks 
correctly. 

5. Do any Helix Universal Server features need to be set up? 


The Helix Universal Server administrator can set up many streaming and 
security features, such as: 


+ live broadcasts 
* pay-per-view content 
* automatic ad insertion 


+ password authentication 


Using Helix Universal Server through an Internet Service Provider 


If an Internet service provider (ISP) hosts your Web pages, contact the ISP 

administrator to check out the Helix Universal Server issues described above. 
Also find out how much disk space you will have for streaming media. Many 
ISPs allot you a certain amount of disk space on their servers, such as 5 or 10 
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Megabytes. Although this is a generous amount for Web pages, it’s not much 
for streaming media. A single video clip can easily take up that much space. 


Web Server Downloading 


Although Web servers can deliver some streaming clips, they don’t have Helix 
Universal Server’s ability to synchronize clips and keep long presentations 
flowing smoothly. When only a Web server is available, you can still deliver 
multimedia presentations, but you will not be able to use all of the features 
that RealOne Player offers. 


For More Information: If you plan to deliver clips with a Web 
server, read “Limitations on Web Server Playback” on page 524. 


Local Playback 


You can also create presentations that play back from a user’s local computer. 
An example of this is a multimedia-enhanced book written with HTML and 
linking to clips. Users download the files to their computers, playing back the 
media clips with RealOne Player. In this case, you produce clips as described in 
this guide, except that you don’t target specific network connection 
bandwidths. In the HTML pages, URLs point to clips on the user’s computer 
instead of on Helix Universal Server. 


For More Information: For more on local URLs in SMIL files, see 
“Linking to Local Clips” on page 216. See also “Launching 
RealOne Player with a Ram File” on page 507. 


Step 2: Learn the RealOne Player Interface 


RealOne Player integrates streaming media with HTML pages simply and 
effectively. Because previous versions of RealPlayer did not natively display 
HTML pages, linked pages opened in the viewer’s default Web browser, which 
split the presentation between separate applications. RealOne Player closes 
this divide, benefitting both the viewer, who does not have to switch between 
applications to watch an integrated presentation, and the presentation 
author, who can more easily coordinate streaming media with Web pages. 


A thorough understanding of how RealOne Player’s various panes let you 
coordinate streaming media with HTML pages helps you to envision the types 
of presentations that you can deliver. This section covers these interface 
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elements, and then discusses the types of production techniques that you can 
use to tie your media and your HTML pages together. RealOne Player 
supports several different production techniques, suitable for everyone from 
beginning media authors to Web professionals. 


The Three-Pane Environment 


The following figure illustrates the RealOne Player environment, which is 
based on the metaphor of “play/more/explore.” Here, the Media Playback 
pane plays streamed or downloaded clips. The Related Info pane gives the 
viewer more information about the presentation. The detachable Media 
Browser pane and any secondary browsing windows let the viewer explore the 
World Wide Web. This design gives you one pane for playing media, one pane 
for displaying small HTML pages related to the media, and one or more 
windows for showing large Web pages, such as your home page. 
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RealOne Player Three-Pane Environment with a Secondary Browsing Window 
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The Media Playback Pane 


The media playback pane hosts media clips and includes buttons for play, 
pause, rewind, volume control, and so on. Any streaming or downloaded 
media playable in RealOne Player can display in this pane. This includes the 
core clip types and markup languages described in “Step 3: Choose Clip Types 
and Gather Tools” on page 39. In addition, RealOne Player can play many 
other media types, including MPEG audio and video. 


Media Playback Pane Sizing 


The media playback pane automatically scales to the size of the playing media. 
If no HTML page displays in the related info pane as media plays, the media 

playback pane appears centered above the media browser pane as shown in the 
following figure. The media browser pane’s resize handle allows the viewer to 
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adjust the relative heights of the top and bottom halves of the three-pane 


environment. 


Media Playback Pane Centered Above the Media Browser Pane 
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Tip: As explained in “Making Room for the Related Info Pane” 
on page 374, you can use SMIL to display the media playback 
pane at the left side of the RealOne Player window instead of in 


the center. 


Media Playback Pane Alone 

If the viewer has detached or closed the media browser pane, the media 
playback pane encloses the playing media, as illustrated in the next figure. 
This gives the viewer access to media in a smaller pane that includes just the 


necessary controls for adjusting media playback. 
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Media Playback Pane Without the Media Browser Pane 
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Media Playback and Related Info Panes 

If a media presentation opens an HTML page in the related info pane, the 
media playback pane automatically expands to display both the media and the 
HTML page, as shown in the next figure. 


Media Playback Pane With the Related Info Pane 
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Visualizations for Audio-Only Clips 

When playing audio-only clips, the viewer can display in the media playback 
pane a visualization, such as an audio analyzer consisting of bars that rise and 
fall in response to the strength of various audio frequencies. 
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A Visualization in the Media Playback Pane 
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Double-Size and Full-Screen Modes 

Content authors and viewers can also play media at double-size or full-screen. 
In full-screen mode, the media playback pane expands to fill the entire 
computer screen. In this case, no HTML pages in the related info or media 
browser panes display until the presentation ends, or the viewer exits full- 
screen mode. 


The Related Info Pane 


The related info pane, which is also called the “context pane,” appears to the 
right of the media playback pane. It’s designed to display small HTML pages 
that supplement media clips. These pages might contain album cover art, 
copyright information, advertisements, and so on. Although using the related 
info pane is not required, displaying supplemental HTML pages in this pane 
greatly enhances the viewing experience. The related info pane can display any 
HTML page content supported by Microsoft Internet Explorer version 4 or 
later. 


Because the media playback and related info panes are separate, you can easily 
open multiple HTML pages as a presentation plays, displaying each page at a 
specific point in the media timeline. You can thereby update the related info 
pane simply by opening a new HTML page. In contast, when you embed media 
in a Web page, updating the page as the media plays can require complicated 
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scripting. RealOne Player thereby lets you focus on your media, and display 
any number of supplemental HTML pages by using simple production 
techniques. 


Note: Because no divider marks the boundary between the 
media playback and related info panes, it’s easy to blend the 
panes by setting the same background colors. For the related 
info pane, you set the background color in the HTML page. 
Later sections in this guide explain how to set the media 
playback pane’s background color through various methods. 


Related Info Pane Sizing 


The RealOne Player production techniques described in this guide let you set 
the size of the related info pane. If you do not specify a size, the pane uses a 
default width of 330 pixels, and a height the same as the media playing in the 
media playback pane. If the page content is too large for the specified size, the 
pane displays scroll bars the same as a standard browser window. 


The related info pane’s size is fixed for the presentation’s duration. As a clip or 
SMIL presentation plays, the first URL that opens in the related info pane sets 
the pane size. If a subsequent URL opens in the related info pane while the 
same clip or presentation plays, any sizing information in that URL is ignored. 
You can specify a new related info pane size, though, when starting a new clip 
or SMIL presentation. 


Tip: Because of the generally small size of the related info pane, 
using frames in this pane is not recommended. 


Media Clips Set the Minimum Height 

You can set the related info pane to a height greater than the media, but not 
smaller. If your media is 300 pixels high, for example, your related info pane 
will be 300 pixels high even if you specify a shorter height, such as 200 pixels. 
However, you can create a related info pane that is taller than your media, such 
as 400 pixels. In this case, RealOne Player centers the media playback pane 
vertically alongside the related info pane. 


Media Browser Pane Can Override the Width 

When the bottom media browser pane is attached to the top two panes, it may 
increase the width of the related info pane. Suppose that you play a media clip 
that is 200 pixels wide, and you specify a related info pane width of 300 pixels. 
If the media browser pane is not attached, the width of the top two panes is 
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500 pixels. If a 600-pixel-wide media browser pane is attached, though, 
RealOne Player adds 100 pixels to the related info pane width to increase the 
overall width of the top panes to 600 pixels. 


HTML Page Caching 


RealOne Player caches the HTML pages that display in the related info pane 
for the duration of a presentation. It deletes this cache when a new clip plays. 
RealOne Player does not normally cache media clips that play in the media 
playback pane. However, when you use SMIL, you can make RealOne Player 
cache small clips, such as images, that display in the media playback pane. 


For More Information: See “Caching Clips on RealOne Player” 
on page 219 for more information about RealOne Player’s 
CHTTP caching protocol for small media clips. 


The Media Browser Pane 


The media browser pane can attach to, or detach from, the media playback 
and related info panes. When attached, it appears below the two other panes. 
Detached, it appears as a stand-alone window that the viewer can resize and 
close independently of the media playback and related info panes. Sending an 
HTML page URL to a closed media browser pane reopens the pane, however. 


Through the media browser pane, RealOne Player users can surf the Web, play 
CDs, access their personal media libraries, transfer clips to portable players, 
and so on. Presentation authors can also use this pane to display Web pages 
associated with a streaming presentation. The pane supports any content 
playable in Microsoft Internet Explorer version 4 or later, including Javascript. 
You might use this pane to display your home page after a media presentation 
plays, for example. 


‘Now Playing’ List 
In the left side of the media browser pane, viewers can display a clickable “Now 
Playing” list. When the viewer plays a media clip or presentation, the clip or 
presentation title displays in this list. Additionally, the viewer can build a clip 


list by dragging media links from an HTML page displayed in the related info 
or media browser pane. 
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RealOne Player ‘Now Playing’ List 
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Secondary Browsing Windows 


Like most Web browsers, RealOne Player can display any number of additional 
browsing windows, which are independent of the three-pane environment. 
You can display Web pages associated with your presentation in secondary 
browsing windows, for example. Displaying full Web pages in the main media 
browser pane is preferable in most cases, though, because many viewers are 
likely to have that pane already attached to the media playback and related 
info panes. Additionally, only the media browser pane includes the “Now 
Playing” list. 


Using Media Clips to Open HTML Pages 


You can use three different techniques to open URLs in an HTML pane as a 
media clip plays. These techniques allow you to create “media-driven” 
presentations, in which supplemental information displays in the HTML 
panes at a specific point in the media timeline, or in response to viewer 
interaction with clips. 


Appending HTML URLs to Clip URLs in a Ram File 


You typically use a Ram file, which uses the extension .ram, to launch media 
clips that play in RealOne Player. As the section “Passing Parameters Through 
a Ram File” on page 510 explains, you can add to the Ram file the URLs for 
HTML pages that open in the related info or media browser pane. This Ram 
file method is easy to use, and is well-suited for simple presentations, such as a 
single RealVideo clip that displays an HTML page as it plays. 


Embedding HTML URLs Into a Clip 


When you create a RealVideo or RealAudio clip with Helix Producer, you can 
write an events file that defines one or more URLs that open in a RealOne 
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Player HTML pane at certain points as the clip plays. You then use a utility 
that embeds the events into the clip. Whenever you stream the clip, the 
encoded URLs open automatically. Introduction to Streaming Media provides 
more information about this production technique. 


Using SMIL to Coordinate Clips and HTML Pages 


To lay out and synchronize multiple media clips, you use Synchronized 
Multimedia Integration Language (SMIL). A SMIL presentation always plays 
in the media playback pane, but it can also open HTML pages in the other 
panes. Using SMIL gives you more control over HTML display than using a 
Ram file, or encoding URLs directly into clips. You can learn about SMIL 
starting with Part IV of this guide. Chapter 15 covers SMIL’s hyperlinking 
attributes. 


Controlling a Presentation Through HTML Pages 


Through HTML pages displaying in the related info pane or media browser 
pane, you can control the media displaying in the media playback pane, as well 
as open new HTML pages. These production techniques, which you can mix 
with the media-based techniques described previously, allow you to create 
“user-driven” presentations, in which clips and HTML pages display according 
to viewer action within the HTML panes. 


Linking One HTML Pane to the Other 


The most basic way to link one HTML pane to another is through a simple 
hypertext link in the form <a href>. You can open a new HTML page in the 
media browser pane through a hypertext link in the related info pane by 
adding a target="_rpbrowser” attribute to the <a href> tag: 


<a href="URL” target="_rpbrowser"> 


Any other target name will open the HTML page in a secondary window that 
is detached from the basic three-window environment. 


You should not attempt to open an HTML page in the related info pane with a 
simple link in the media browser pane, however, because the related info pane 
URL requires sizing information that you cannot pass in the link. However, 
the Javascript/VBScript methods described below let you pass this 
information. 
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Launching a Clip with an HTML Page Link 


If you link to a Ram file with a simple <a href> link as described in “Launching 
RealOne Player with a Ram File” on page 507, the clip or SMIL presentation 
listed in the Ram file automatically plays in the media playback pane. You do 
not need to use any additional window targeting attributes. To avoid a file 
download dialog, though, you can use the Javascript or VBScript methods to 
play clips when the viewer clicks certain links. 


Using Javascript and VBScript Methods 


RealOne Player supports several methods that work with both Javascript and 
VBScript. Used in HTML pages displaying in the related info pane or media 
browser pane, these methods give you more control than standard <a href> 
links. They are intended for HTML pages displaying in the RealOne Player 
environment, however, and not for HTML pages rendered by other browsers. 


The Javascript/VBScript methods are well-suited for creating Internet-based 
audio and video jukeboxes, for example. Using these methods, you can create 
interactive presentations that add clips to the “Now Playing” list, for example, 
or play clips based on viewer interaction with forms or elements displayed in 
the related info or media browser pane. 


For More Information: For information about using Javascript 
and VBScript methods with RealOne Player, see RealOne Player 
Scripting Guide. 


Step 3: Choose Clip Types and Gather Tools 


RealOne Player gives you many possibilities for creating streaming media. 
Your presentation may consist of a single clip, or several clips that play 
together. As described in the preceding section, RealOne Player can also 
display HTML pages while clips play. After you decide what types of clips you 
want to stream, you'll need to gather the production tools used to make the 


clips. 


Audio and Video 


RealAudio and RealVideo are the most popular streaming media formats. To 
produce them, you run an encoding tool that takes audio or video input from 
one of these sources: 


+ alive source, such as a video camera or microphone 
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+ recorded media such as tape or CD 
- a digitized file in a standard, uncompressed format 


On Windows, WAV (.wav) and AVI (.avi) are the most popular audio and 
video formats, respectively. On the Macintosh, QuickTime (.mov) and 
AIFF (.aiff) are commonly used. Unix users often start with MPEG (.mpg, 
.mpeg). 


Tip: If RealOne Player can open a clip, you typically can stream 
that type of clip with Helix Universal Server, as long as the clip 
is not in a format meant only for downloading. Only 
compressed clips stream well, though. Uncompressed WAV is 
not a good streaming format, for example, because it requires a 
lot of bandwidth for even a small clip. 


Audio and Video Production Tools 


A streaming RealAudio or RealVideo clip results from gathering, editing, and 
encoding audio or video input. To carry out the initial steps of gathering and 
editing content, you'll need the following: 


- Avideo camera and a microphone 


To capture live input, use any video camera and microphone that can be 
attached to your computer. You will not need these devices, though, if 
your audio or video source is already digitized. 


An audio/video capture card 


To take input from a microphone or camera, your computer needs an 
audio/video capture card. This card accepts the input and digitizes it into 
a format you can edit. On Windows computers, you can use any video 
capture card that supports Video for Windows. 


Audio and video editing software 


These programs let you edit digitized audio and video files. When creating 
clips that stream on demand, it’s best to edit and optimize the input 
before encoding it. When broadcasting, you can convert audio and video 
input into RealAudio or RealVideo clips directly from a capture card 
without first creating a separate, digitized file. 


Producing RealAudio and RealVideo does not require that you use specific 
microphones, cameras, capture cards, or editing tools. Just ensure that your 
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editing tools can save files in formats that you can easily convert to streaming 
formats with your encoding tool. 


For More Information: Chapter 3 and Chapter 4 describe the 
RealAudio and RealVideo formats in detail. 


RealAudio and RealVideo Encoding Tools 


SMIL 


Some editing programs can export digitized audio and video directly to 
RealAudio or RealVideo. If your editing program cannot export clips, or you 
don’t want to use this feature, you can use a RealNetworks tool to encode clips 
from files in standard formats such as WAV, AVI, QuickTime, and MPEG. 
Helix Producer Basic is a free tool for encoding RealAudio and RealVideo 
clips. Helix Producer Plus is an enhanced version that offers more encoding 
features. 


Helix Producer Creates Streaming Clips 
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For More Information: For more information about Helix 
Producer, see “Getting Production Tools” on page 533. You can 
also learn more at http://www.realnetworks.com/products/ 
producer/index.html. 


When you want to combine two or more clips into a single presentation, you 
use SMIL. Pronounced “smile,” SMIL is a simple markup language that tells 
RealOne Player how to lay out and play your clips. You can use any word 
processor or text editor to write SMIL. To learn SMIL, start with Chapter 8. 
For basic information about SMIL syntax, see “Writing SMIL Files” on page 
535. 
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Animation 


Images 


With Macromedia Flash animation, you can build anything from streaming 
cartoons to e-commerce applications. Using version 5 of the Flash application, 
you can export an animation directly for streaming to RealOne Player, 
complete with a RealAudio soundtrack. A streaming Flash clip uses the file 
extension .swf. See Chapter 5 for details about producing Flash animation for 
RealOne Player. Learn more about Flash from Macromedia’s Web site at: 


http://www.macromedia.com/software/flash/ 


RealOne Player also plays animations in the Scalable Vector Graphics (SVG) 
format. You can learn more about SVG at Adobe Corporation’s Web site: 


http://www.adobe.com/svg/main.html 


Still images can display in the media playback pane, as well as the media 
browser and related info panes. For images displayed in the media playback 
pane, you can use any of the following formats: 
+ GIF87, GIF89, and animated GIF (.gif) 
Both interlaced and noninterlaced GIFs will work, but noninterlaced GIFs 
are recommended. 
» JPEG (jpg) 
RealOne Player can display grayscale and RGB baseline JPEGs. Progressive 
JPEGs are not supported. 
+ PNG (.png) 
RealOne Player can display most PNG images, but it does not adhere to 


gamma settings in PNG images. 


Note: Several SMIL extensions let you adjust colors and 
transparency within an image clip. For more information, see 
“Modifying Clip Colors” on page 222. 


Images in SMIL Presentations 


To add images to streaming presentations as backgrounds or buttons, for 
example, simply incorporate the images by using SMIL. This way, you can 
specify exactly where images appear in relation to your clips. You can also use 
SMIL to turn images into hyperlinks. 


Text 


CHAPTER 2: Presentation Planning 


RealSlideshow Presentations 


When you want to create a streaming slideshow, the easiest solution is to use 
RealSlideshow™ or RealSlideshow Plus. These tools have drag-and-drop 
interfaces that let you quickly build your slideshow, which can include text 
captions, audio narrations, and background music. RealNetworks’ partners 
will even host your streaming slideshow. Get RealSlideshow at: 


http://www.realnetworks.com/products/slideshow/index.html 


RealPix Markup 


Streaming slideshows are based on the RealPix markup language. Instead of 
using RealSlideshow, you can write your own markup to assemble images into 
a RealPix presentation that has eye-catching special effects such as dissolves 
and zooms. Chapter 7 explains the RealPix markup language. 


As the section “Adding Text to a SMIL Presentation” on page 227 explains, 
there are three ways to add text to a SMIL presentation that displays in the 
media playback pane. You can display a plain text file (.txt), add text directly to 
your SMIL file, or display a RealText clip (.rt), which displays text at specific 
times within a presentation. As well, you can display HTML text in the 
RealOne Player related info and media browser panes. Chapter 6 describes 
RealText markup. 


Autoupdate Feature 


RealOne Player’s plug-in and autoupdate technologies ensure that your clips 
can reach the widest audience possible. RealOne Player plug-ins function like 
Web browser plug-ins. If RealOne Player doesn’t have a plug-in needed to play 
a particular streaming clip, it downloads that plug-in. RealOne Player can even 
use its autoupdate technology to upgrade itself to a new version when 
necessary. 


The following figure illustrates the process for downloading a new plug-in. In 
step 1, RealOne Player encounters an unknown clip type. Next, it contacts 
RealNetworks to determine if a plug-in for that type of clip is available. The 
RealNetworks server then downloads the new plug-in to RealOne Player, as 
shown in step 3. In the final step, RealOne Player plays the clip using the new 
plug-in. 
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RealOne Player Downloads Plug-ins it Needs from the Internet 
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Compatibility with Earlier Versions of RealPlayer 


Plug-in and autoupdate technologies were introduced with RealPlayer G2. 
Earlier versions of RealPlayer cannot upgrade themselves, so they cannot play 
all the clips described in this production guide. Generally, you don’t need to 
be concerned with backward compatibility because most RealPlayer users 
upgrade to the latest release. The following table summarizes which versions 
of RealPlayer offer which features. RealPlayer 4.0, for example, plays only 
RealAudio and RealVideo. 


Supported Features in RealOne Player and Earlier RealPlayer Versions 


Feature RealOne 8 7 G2 5 4 3 2 1 
RealAudio streaming X X|X}]X]X}]X |X] xX |X 
RealVideo streaming xX pia eal a, Gal Fae? an ca ee 
Flash 2.0 streaming xX Me 1M |e |e |] |S le] 
Flash 3.0 and 4.0 streaming X Kees ce] See eS RS 
RealPix streaming X M |x |e |e |e |= |= le 


(Table Page 1 of 2) 
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Supported Features in RealOne Player and Earlier RealPlayer Versions (continued) 


Feature RealOne 8 7 G2 5 4 3 2 1 
RealText streaming X Me bel | Allee Wy ae a ee Nh 
SMIL 1.0 presentations X LOS || Ss | SS) =) S| S 
SMIL 2.0 presentations Xx ae (ea eae | 
Plug-ins for additional clip types X Xe |laaXea exes |e cares lea |= 
Autoupdate xX paul a. a VIS, a] fee (a ee = 


(Table Page 2 of 2) 


This table covers general clip compatibility, but other factors may prevent 
backwards compatibility. For example, not all RealAudio and RealVideo 
codecs are compatible with earlier versions of RealPlayer. If you are concerned 
about backwards compatibility, make sure that you understand the specifics 
of each clip type as described in the various chapters of this guide. 


Protection of Copyrighted Content 


Unlike a Web browser, RealOne Player does not store media clips in a disk 
cache, or allow users to copy or download still images. This helps you keep 
copyrighted material secure when you stream clips from Helix Universal 
Server, though not from a Web server. A Helix Producer option lets you encode 
RealAudio and RealVideo clips so that viewers can record the clips on their 
computers. For managing copyrighted media, RealNetworks has available a 
Media Commerce Suite, which you can read about at the following Web page: 


http://www.realnetworks.com/products/commerce/index.html 


Step 4: Develop a Bandwidth Strategy 


Any computer connected to a network has a connection bandwidth, which is a 
maximum speed at which it can receive data. Web users with 28.8 Kbps 
modems, for example, can view only those presentations that stream less than 
28.8 Kb of data per second. Presentations that stream more data than that per 
second may stall because the data cannot get over the modems fast enough to 
keep the clips flowing. These presentations will not cause problems for users 
with faster connections, though. 


Successfully targeting your audience’s connection bandwidth is crucial for 
developing streaming media. Viewers don’t like to wait more than a few 
seconds for playback to begin after they click a link. And if your clips sputter 
because they use too much bandwidth, viewers are not likely to stay tuned. 
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Developing a bandwidth strategy helps ensure that clips play back quickly and 
don’t stall. You can also devise ways to deliver good clips to users with slow 
connections, and great clips to those with fast connections. 


Presentation Data Must Fit RealOne Player’s Bandwidth 


56 
BHRHEEHE EEE RBBB RRs i Kbps 
34 Kbps of Data Modem 
Server Stalled Presentation 
= 
os 
Sos oO = 56 
PTT Tree Pgs aa iELts i Kbps 
Modem 


80 Kbps of Data ———= 


TTTILLILLLT Tr ie 
PT eee OOOOOOO OS OTT Oo aon 


80 Kbps of Data 


Buffering 


For each streaming clip, RealOne Player keeps a “buffer” that acts as a data 
reservoir. Data enters the buffer as it streams to RealOne Player, leaving the 
buffer as RealOne Player plays the clip. The buffer helps ensure that lapses of 
available bandwidth don’t stall the presentation. If network congestion halts 
the flow of data for a few seconds, for example, RealOne Player keeps the clip 
playing with the buffered data. Your goal is to minimize initial buffering and 
eliminate rebuffering. 


Initial Buffering (Preroll) 


RealOne Player buffers a few seconds of data before a clip plays. Also called 
“preroll,” initial buffering is required for every clip. Developing clips that use 
an appropriate amount of bandwidth keeps preroll to an acceptable level. You 
want preroll to be low—less than 15 seconds for each clip. RealAudio and 
RealVideo encoding tools set a low preroll for you. With other clips, though, 
how you create the clip determines its preroll. 


Rebuffering 


When clip data has stopped coming in and the clip buffer is empty, RealOne 
Player has to halt clip playback to store data again, or “rebuffer.” Sometimes 
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this is unavoidable because the viewer’s available bandwidth drops for too 
long. When developing a multiclip presentation, though, you need to consider 
timelines carefully so that you don’t inadvertently cause rebuffering, which 
can happen if too many clips fight for too little bandwidth. 


Audience Bandwidth Targets 


Your streaming presentations should never consume all of your audience’s 
connection bandwidth. They must always leave bandwidth for network 
overhead, error correction, resending lost data, and so on. Otherwise, they may 
require frequent rebuffering. The following table recommends maximum 
streaming speeds for common network connections. To reach 56 Kbps 
modems, for example, a presentation should stream no more than 34 Kb of 
data per second. 


Maximum Streaming Rates 


Target Audience Maximum Streaming Rate 
14.4 Kbps modem 10 Kbps 

28.8 Kbps modem 20 Kbps 

56 Kbps modem 34 Kbps 

64 Kbps ISDN 45 Kbps 

112 Kbps dual ISDN 80 Kbps 

Corporate LAN 150 Kbps 


256 Kbps DSL/cable modem | 225 Kbps 
384 Kbps DSL/cable modem | 350 Kbps 
512 Kbps DSL/cable modem | 450 Kbps 
786 Kbps DSL/cable modem | 700 Kbps 


For any other connection speed, calculate the maximum streaming speed as: 


- Approximately 75 percent of the connection bandwidth for analog 
connections such as dial-up modems. 


-Or- 


- Approximately 90 percent of the connection bandwidth for high-speed 
digital connections such as DSL or cable modems. 
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Multiclip Presentations 


When several clips are played together, their streaming speeds added together 
should not exceed the connection maximum. For example, RealPix and 
RealAudio clips streaming at 12 and 8 Kbps, respectively, can play in parallel 
over 28.8 Kbps modems because together they stream at 20 Kbps. However, 
they cannot play back together if they stream at 12 and 16 Kbps, respectively, 
because the 28 Kbps total streaming speed leaves the modem no bandwidth 
for overhead. Such a presentation would likely require frequent rebuffering. 


Streaming at Less than the Maximum Speed 


Your presentations do not have to stream at the maximum speeds listed in the 
preceding table. In some cases, you may want your clips to stream at less than 
the maximum: 


- If your clip or presentation opens up large HTML pages in the RealOne 
Player media browser or related info pane, you may need to leave some 
bandwidth available so that RealOne Player can download the pages at a 
reasonable rate. This is especially true when delivering a presentation over 
a modem. 


+ You may need to leave enough bandwidth for the user to perform other 
network activities. When streaming an Internet radio station, for example, 
leave some bandwidth for the listener to view Web pages. 


+ Bandwidth is shared by everyone on a local area network (LAN). If the 
LAN is heavily used, the 150 Kbps LAN target speed may slow down the 
LAN too much. For an intranet, the LAN manager should decide the 
maximum streaming rate. 


Clip Bandwidth Characteristics 


To reach your target audiences with your clips, you need to understand your 
clips’ bandwidth characteristics. 


RealAudio and RealVideo 


A RealAudio and RealVideo encoding tool can turn your source audio or video 
file into a clip that streams to any target connection with little preroll. But if 
the tool has to squeeze a file down too much to reach a low-bandwidth target, 
clip quality may degrade. So although the clip will stream well, you might not 
like the results. To ensure good-quality playback, keep your streaming 
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bandwidths in mind when creating source files, especially when you plan to 
reach dial-up modem users. 


For More Information: See “Understanding RealAudio” on page 
59 and “Understanding RealVideo” on page 73. 


Flash 


Macromedia Flash streams well at low bandwidths, making it an attractive 
alternative to video. Low streaming speed doesn’t affect Flash’s visual quality 
as it can with video. At low bandwidths, though, you may not be able to 
include as many items in your animated scenes as when streaming at high 
bandwidths. After you develop a Flash clip for RealOne Player, you tune it to 
stream at a specific bit rate. For more on this, see “Flash Bandwidth 
Characteristics” on page 92. 


RealText and SMIL 


Because RealText and SMIL files are plain text, they use little bandwidth. You 
generally don’t need to be concerned about how they affect a presentation’s 
bandwidth consumption. 


RealPix (Slideshows) 


RealPix bandwidth use depends on the image sizes and how soon each image 
must appear in the clip’s timeline. At higher bandwidths, you can use larger 
images and display them at shorter intervals. By varying image size and the 
RealPix timeline, you gain a lot of control over bandwidth use. RealSlideshow 
always ensures that images stream at a rate appropriate for your target 
audience. If you write RealPix markup by hand, though, you need to balance 
bandwidth, image sizes, and the slideshow timeline. 


For More Information: See “Managing RealPix Bandwidth” on 
page 154. 


Images in SMIL Presentations 


JPEG, GIF, or PNG images in a SMIL presentation stream at 12 Kbps. See 
“Setting a Clip’s Streaming Speed” on page 210 for instructions on changing 
this streaming bit rate. 
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Reaching Multiple Audiences 


To provide good content for users with slower connections, and great content 
for those with faster connections, you can use two methods, combining them 


if needed: 


+ Create a single RealAudio or RealVideo clip that targets different audience 
bandwidths by using SureStream technology. 


+ Create separate clips for each bandwidth target, and let RealOne Player 
choose which set of clips to play through SMIL. 


Either way, you add to your Web page just one link for all visitors. You don’t 
need separate links for dial-up modems and DSL connections, for example. 


SureStream RealAudio and RealVideo 


Using SureStream technology, you can encode a RealAudio or RealVideo clip 
for multiple bandwidths. For example, you can encode a single RealAudio 
music clip for 28.8 Kbps modems, 56 Kbps modems, 112 Kbps dual ISDN, 256 
Kbps DSL, and so on. The clip’s playback quality improves with each faster 
speed. When a viewer clicks a link to a SureStream clip, RealOne Player and 
Helix Universal Server determine which stream to use based on the available 
bandwidth, as shown in the following illustration. 


SureStream Clip Encoded for Multiple Bandwidths 


——————————————— = 56 Kbps 
TITIILITts 1 Modem 
sulesteen 34 Kbps of Data 
RealVideo p 
—_—_—_—_—e_a—eoeoeee 112 
Trt @ 
BEB BERR 1 Kbps 
— “cite sa seatsa gt ISDN 
80 Kbps of Data 
TTT 256 
COOP eee Peeper gs | 4 K. 
PT ou OCeOOOOOOO OOO TO 8 | bps 
TPO P eee UP e Pepe | - DSL 


225 Kbps of Data 


Helix Universal Server and RealOne Player can even adjust this choice to 
compensate for network conditions. If a fast connection becomes bogged 
down because of high network traffic, Helix Universal Server switches to a 
lower-bandwidth stream to prevent the presentation from stalling. When the 
congestion clears, Helix Universal Server switches back to the higher- 
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bandwidth stream. RealOne Player doesn’t need to rebuffer data during this 
shifting. 


Switching Bandwidths During Network Congestion 


® 


SureStream 34 Kbps of Data 
RealVideo Network Biel 


Congestion ®) 
HEHE BEE HE EE EERE (1) 


20 Kbps of Data 


56 Kbps 


‘S) Modem 


34 Kbps of Data 


Switching Between Multiple Clips with SMIL 


Only RealAudio and RealVideo clips can stream at multiple bandwidths. You 
can create multiple versions of other clips, though, each for a different 
bandwidth. RealOne Player then chooses which clip to play based on a SMIL 
bandwidth parameter. The following illustration shows a SMIL file that lists 
separate high-bandwidth and low-bandwidth RealPix clips. Each RealOne 
Player evaluates the SMIL file and chooses the RealPix clip appropriate for its 
connection speed. Both presentations use the same SureStream RealAudio 
clip, though, which has been encoded internally for multiple bandwidths. 
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Bandwidth Choices through a SureStream Clip and SMIL 


Low Bandwidth 


RealPix A 
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SureStream eee 
RealAudio 


Helix Universal 
Server 
and SMIL File 
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When you use SMIL for bandwidth choices, Helix Universal Server cannot 


downshift to a lower-bandwidth clip group the way it can downshift to a 


slower SureStream stream. Helix Universal Server employs other techniques, 


though, to compensate for network congestion. Its stream thinning 


capabilities enable it to drop low-priority data to decrease the presentation 


bandwidth temporarily. When the network congestion clears, Helix Universal 


Server continues to stream all the presentation data. 


For More Information: “Switching Between Bandwidth Choices” 


on page 446 explains how to use SMIL to designate different 


bandwidth groups. 


Step 5: Organize the Presentation Timeline 


Every streaming media clip has a timeline. A RealAudio clip may play for five 


minutes, for example, giving it a five-minute timeline. When clips are 


streamed together, you have a presentation timeline as well. Before producing 


clips, plan the presentation timeline. Among other things, the timeline can 


determine the order in which you produce clips. A well-conceived timeline also 


helps ensure that clips do not overload a connection’s bandwidth and cause 


rebuffering. 


Timeline Considerations 


When you assemble a streaming media presentation, you can manipulate 


various aspects of clip timelines. 
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Clips with Internal Timelines 


Audio, video, and animation have internal timelines. In a 10-minute video, for 
instance, each frame corresponds to a specific point in a 10-minute timeline. 
Each second of audio meshes with each second of the image throughout the 
clip’s overall timeline. Your video, audio, or animation software is your main 
tool for manipulating the clip’s timeline, which is woven into the fabric of the 


clip. 


Clips with Variable Timelines 


With RealPix or RealText, you use the markup language to control when each 
image or text block appears, and how long it lasts. When combining clips, it’s 
typically easier to produce audio, video, or animation first. Then set the 
RealPix and RealText timelines to coordinate with those clips. 


SMIL Timing Commands 


A SMIL file can include its own timing elements. Timing a presentation with 
SMIL can be as simple as having one clip start as soon as another one stops. 
But you can also use commands to delay playback for 10 seconds, for example, 
or to have a clip start playing 30 seconds into its internal timeline. SMIL’s 
timing commands are optional, but they give you the flexibility you may need 
for some presentations. 


For More Information: For more on SMIL timing, see Chapter 
13. 


Timelines for Multiclip Presentations 


For presentations that include multiple clips, consider how to group clips 
without overloading an audience’s connection bandwidth. The following 
illustration shows poor timeline planning. At various points, a video and a 
slideshow clip playing together exceed the connection’s maximum streaming 
speed, which is represented below by the dashed line. Illustrated by the solid 
line, bandwidth use peaks again when the second video clip begins to play 
before the first video clip finishes. This presentation requires a high preroll for 
clips and would likely result in rebuffering at peak points. 
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Poor Bandwidth Use in a Multiclip Presentation 
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The next illustration shows better timeline planning and bandwidth 
management. The presentation starts with a low-bandwidth text clip that 
does not interfere with the streaming of the images in the image slideshow. A 
video clip starts after the slideshow has streamed all of its images and does not 
need any more bandwidth. The second video clip starts after the first video 
clip has ended, so the two clips do not compete for bandwidth. 


Improved Bandwidth Use in a Multiclip Presentation 
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Timeline Management 
When developing a streaming presentation, keep the following in mind: 


+ Consider the presentation timeline carefully to eliminate bandwidth 
bottlenecks. These typically occur when two or more high-bandwidth 
clips play simultaneously. You may need to omit high-bandwidth pairings, 
combining high-bandwidth clips with low-bandwidth clips instead. 


Stagger the start times for clips. Every clip requires a certain amount of 
preroll before RealOne Player can play it. Your presentation will flow more 
smoothly if Helix Universal Server does not need to send more than one 
clip’s preroll at a time. 


Start presentations with low-bandwidth clips. For example, use RealText 
to display credits. Or begin with a highly compressed RealAudio narration 
before bringing in any other clips. Helix Universal Server can take 
advantage of the extra bandwidth to begin streaming higher-bandwidth 
data to RealOne Player “behind the scenes.” 


Test your presentations in “real world” circumstances, replicating your 
audience’s bandwidth conditions. Clips may play back OK from your 
desktop computer but bog down when streamed over a modem. 


If you become an advanced SMIL author, you can use prefetching, a 
powerful bandwidth management feature that lets you stream portions of 
large clips, or all data for small clips, before the clips play. Chapter 19 
explains prefetching. 


Step 6: Get Started With Production 


When you've decided how you'll stream clips, chosen clip types and tools, 
developed a bandwidth strategy, and planned a timeline, you’re ready to start 
creating streaming presentations. The following sections point you to the 
chapters you should read to carry out certain jobs. Also, be sure to familiarize 
yourself with this guide’s appendixes. Appendix B, for example, points you to 
specific information about performing specific tasks. The markup appendixes 
summarize all tags, helping you to locate features quickly. 


Tip: This guide does not explain how to use any specific tools, 
such as Helix Producer or Macromedia Flash. Be sure to have 
the documentation for your production tools handy as you 
develop your clips. 


55 


56 


RealNetworks Production Guide 


| plan to stream just audio and video clips. 

Read Chapter 3 and Chapter 4 to learn about RealAudio and RealVideo, 
respectively, and to pick up general audio and video production tips. Refer to 
your Helix Producer User’s Guide for instructions on running Helix Producer to 
encode the streaming clips. Chapter 21 explains how to write a Ram file that 
links your clips to a Web page. 


| want to open HTML pages with my audio and video clips. 

The section “Passing Parameters Through a Ram File” on page 510 explains 
how to open HTML page through simple parameters listed in a Ram file. If 
you need more functionality, you can write a SMIL file to open any number of 
Web pages at any time. Chapter 8 explains the basics of SMIL, and Chapter 15 
covers SMIL’s extensive hyperlinking capabilities. 


| want to embed my audio and video clips in a Web page. 
Chapter 20 explains embedding markup. To extend the basic embedded 
functionality using Javascript or VBScript, see RealOne Player Scripting Guide. 


| want to stream Macromedia Flash animation. 
Chapter 5 provides tips for making Flash animation stream well. Consult your 
Flash documentation for instructions about using the Flash application. 


| want to create a slideshow. 

Chapter 7 explains the RealPix markup for streaming still-image slideshows. If 
you want to combine your slideshow with another clip, such as an audio 
soundtrack, you'll need to use SMIL. 


| want to learn about SMIL. 

Start with Chapter 8 to learn the basics of SMIL. Part V, beginning on page 
233, and Part VI, beginning on page 309, explain the basics of SMIL layout 
and timing. Part VII, beginning on page 389, takes you through the more 
advanced SMIL features. 


PRODUCING CLIPS 


Individual clips are the building blocks of a streaming media 
presentation. In this section, Chapter 3 and Chapter 4 take on 
RealAudio and RealVideo production, respectively. Read 
Chapter 5 to learn how to stream Macromedia’s Flash 


animation. 


PART 


CHAPTER 


3 


AUDIO PRODUCTION 


RealNetworks pioneered streaming audio with RealAudio, the first 
streaming media product for the Internet. Since its debut in 1995, 
RealAudio has become the standard for network audio, delivering 
stereo sound over 28.8 Kbps modems and CD-quality sound at high 
connection speeds. This chapter gives pointers on how to prepare 


and encode your sound files for streaming. 


Understanding RealAudio 


Because RealAudio clips are compressed, you typically start with a sound file 
in a digitized, uncompressed format such as WAV or AIFF. Using a RealAudio 
encoding tool, you create a RealAudio clip from the source file. RealAudio 
clips use the file extension .rm, although older clips may use .ra instead. This 
section explains how RealAudio encodes an audio file for streaming. This 


knowledge will help you produce high-quality streaming clips. 


Bandwidth and Audio Quality 


One way that RealAudio squeezes an audio file’s size down is by throwing out 
nonessential data. This makes it a Jossy compression format. RealAudio 
doesn’t delete data indiscriminately, though. It first jettisons portions you 
cannot hear, such as very high and very low frequencies. Next, it removes as 
much data as needed while keeping certain frequencies intact. Voice encoding 
favors frequencies in the normal human speaking range. Music encoding 
retains a broader frequency range. 


Although RealAudio is savvy about what audio data it throws out, be aware 
that the lower the connection speed, the more data gets ejected, and the 
cruder the sound quality becomes. At low bandwidths, you get roughly the 
quality of an AM radio broadcast. With faster connections, you can encode 
music with FM-quality sound. And at the high speeds of DSL, cable modems, 
and LANs, RealAudio sound quality rivals that of CD playback. When creating 
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RealAudio clips for low bandwidths, it’s important to start with high-quality 
input, as described in “Capturing Audio” on page 67, to attain good sound 


quality. 


RealAudio Bandwidth Characteristics 


You create a RealAudio clip by using one or more RealAudio codecs. A codec is 
a coder/decoder. It tells an encoding tool how to turn audio source files into 
RealAudio clips. On the receiving end, RealOne Player uses codecs to expand 
clips into audio data the computer can play. RealAudio employs a series of 
codecs, each of which creates an audio stream for a precise bandwidth. One 
codec compresses mono music for a 28.8 Kbps modem. Another one 
compresses stereo music for that same modem speed. This set of codecs is 
different from the set used to compress music for, say, DSL and cable modem 
connections. 


A RealAudio clip consumes bandwidth at a flat rate determined by the codec 
used to encode the clip. A RealAudio clip encoded with a 20 Kbps codec, for 
example, steadily consumes 20 Kbps of bandwidth as it plays. The following 
table lists the standard bit rates for RealAudio clips encoded for specific target 
audiences by Helix Producer. Encoding a voice-only audio file for a 28.8 Kbps 
modem, for example, creates a 16 Kbps streaming clip. With mono music 
input, though, you get a 20 Kbps clip. 


RealAudio Standard Bit Rates 


Voiceand Mono Stereo 
Target Audience Voice Only Music Music Music 
28.8 Kbps modem 20 Kbps |20 Kbps | 20 Kbps 

16 Kbps 

56 Kbps modem 32 Kbps |32 Kbps | 32 Kbps 
64 Kbps single ISDN 32 Kbps 44 Kbps |44Kbps_ | 44 Kbps 
112 Kbps dual ISDN 64 Kbps 64 Kbps 
Corporate LAN 64 Kbps 132 Kbps 
256 Kbps DSL/cable modem 64 Kbps_ | 176 Kbps 

96 Kbps |} 
384 Kbps DSL/cable modem ar 264 Kbps 

§ [ee 

512 Kbps DSL/cable modem P 352 Kbps 


In terms of bandwidth use, RealAudio is the most inflexible media type. The 
RealAudio codecs set streaming bit rates in a stairstep model: 20 Kbps, 36 
Kbps, 44 Kbps, and so on, with no inbetween choices. Because RealAudio clips 
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always stream at specific bit rates, consider their bandwidth needs first when 
you use them in multiclip presentations. Then create your other clips to 
stream within the bandwidth that’s left. 


Note: With SureStream technology, a single RealAudio clip can 
stream at many different speed. For the basics of SureStream, 
see “SureStream RealAudio and RealVideo” on page 50. 


RealAudio Codecs 


This section discusses the RealAudio codecs used by Helix Producer. The 
codecs are listed in separate tables for voice, mono music, and stereo music. 
Voice codecs focus on the standard frequency range of the human voice. Music 
codecs have broader frequency responses to capture more high and low 
frequencies. 


The tables list each codec’s optimum sampling rate. Using a codec’s optimum 
sampling rate in your audio source file ensures that the audio stays 
synchronized with other media in the presentation. It also prevents pitch 
shifting in audio resampling. Audio quality degrades if you use less than the 
optimum sampling rate. If you use a higher rate, it is best to use a multiple of 
the optimum rate. If the optimum rate is 8 kHz, for example, use a higher rate 
of 16 kHz or 32 kHz. When in doubt, use the CD-quality sampling rate of 44.1 
kHz. 


Note: RealProducer 8.5 and Helix Producer can also take audio 
input sampled at a rate of 48 kHz, which is commonly used 
with digital video discs (DVD) and digital audio tape (DAT). 
Helix Producer automatically resamples the input to the 
optimum rates for the selected RealAudio codecs. 


Voice Codecs 


Voice codecs are for voice-only clips. The lowest-speed voice codec normally 
used to encode a RealAudio clip streams data at 16 Kbps. The lower-speed 
codecs (5, 6.5, and 8.5 Kbps) are used as SureStream duress streams that 
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RealOne Player downshifts to if the connection bandwidth drops. They’re also 
used to encode soundtracks for low-bandwidth RealVideo clips. 


RealAudio Voice Codecs 


RealAudio Codec Sampling Rate 
5 Kbps Voice 8 kHz 

6.5 Kbps Voice 8 kHz 

8.5 Kbps Voice 8 kHz 

16 Kbps Voice 16 kHz 

32 Kbps Voice 22.05 kHz 

64 Kbps Voice 44.1 kHz 


Mono Music Codecs 


As with the voice codecs, the lowest-speed mono music codec normally used 
with RealAudio streams data at 16 Kbps. The lower-speed codecs (6, 8, and 11 
Kbps) are used as duress streams in SureStream clips, and to encode 
soundtracks for low-bandwidth RealVideo clips. When there are two versions 
of a codec, Helix Producer uses the higher-response version by default. 


RealAudio Mono Music Codecs 


RealAudio Codec Sampling Rate 
6 Kbps Music 8 kHz 

8 Kbps Music 8 kHz 

11 Kbps Music 11.025 kHz 
16 Kbps Music 22.05 kHz 
20 Kbps Music 22.05 kHz 
20 Kbps Music—High Response 44.1 kHz 
32 Kbps Music 44.1 kHz 
32 Kbps Music—High Response 44.1 kHz 
44 Kbps Music 44.1 kHz 
64 Kbps Music 44.1 kHz 
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Stereo Music Codecs 
RealPlayer G2 or later can play the stereo codecs listed in the following table. 


These stereo codecs do not stream slower than 20 Kbps because, if they did, 
they would not have enough frequency response for adequate sound. 


RealAudio Stereo Music Codecs 


RealAudio Codec Sampling Rate 


20 Kbps Stereo Music 11.025 kHz 
32 Kbps Stereo Music 22.05 kHz 
44 Kbps Stereo Music 22.05 kHz 
64 Kbps Stereo Music 44.1 kHz 
96 Kbps Stereo Music 44.1 kHz 


RealAudio 8 Stereo Music Codecs 


RealAudio 8 introduces new stereo music codecs that greatly enhance sound 
quality, especially over high-speed connections. Only RealPlayer 8 and later 
can play RealAudio 8 clips. Users with RealPlayer G2 and RealPlayer 7 are 
prompted to upgrade to the latest version of RealOne Player before listening 
to a RealAudio 8 clip. When there are two versions of a codec, Helix Producer 
uses the higher-response version by default. These codecs are also used to 
encode voice-with-music clips. 


RealAudio 8 Stereo Music Codecs 


RealAudio 8 Codec Sampling Rate 


12 Kbps Stereo Music 22.05 kHz 
16 Kbps Stereo Music 22.05 kHz 
20 Kbps Stereo Music 22.05 kHz 
20 Kbps Stereo Music—High Response 22.05 kHz 
32 Kbps Stereo Music 22.05 kHz 
32 Kbps Stereo Music—High Response 44.1 kHz 
44 Kbps Stereo Music 44.1 kHz 
44 Kbps Stereo Music—High Response 44.1 kHz 
64 Kbps Stereo Music 44.1 kHz 
66 Kbps Stereo Music 44.1 kHz 
96 Kbps Stereo Music 44.1 kHz 


(Table Page 1 of 2) 


63 


RealNetworks Production Guide 


RealAudio 8 Stereo Music Codecs (continued) 


RealAudio 8 Codec Sampling Rate 
105 Kbps Stereo Music 44.1 kHz 
132 Kbps Stereo Music 44.1 kHz 
146 Kbps Stereo Music 44.1 kHz 
176 Kbps Stereo Music 44.1 kHz 
264 Kbps Stereo Music 44.1 kHz 
352 Kbps Stereo Music 44.1 kHz 


(Table Page 2 of 2) 


Surround Sound Codecs 


The RealAudio Surround codecs preserve the matrixed multi-channel 
surround audio in conventional “surround sound” audio. Surround audio can 
consist of four sound channels (left, right, left surround, and right surround) 
or 5.1 channels (additional subwoofer and center) that are mixed into the two 
conventional left and right stereo channels. To play RealAudio clips encoded 
with these codecs, your viewers need RealOne Player or higher, and an A/V 
receiver equipped with surround sound decoding. 


RealAudio Surround Stereo Music Codecs 


RealAudio 8 Codec Sampling Rate 
44 Kbps Surround Audio 44.1 kHz 
64 Kbps Surround Audio 44.1 kHz 
96 Kbps Surround Audio 44.1 kHz 
132 Kbps Surround Audio 44.1 kHz 
146 Kbps Surround Audio 44.1 kHz 
176 Kbps Surround Audio 44.1 kHz 
264 Kbps Surround Audio 44.1 kHz 
352 Kbps Surround Audio 44.1 kHz 


Older RealAudio Codecs 


The following tables list older RealAudio codecs that became obsolete with 
RealPlayer G2. Some of these codecs are still used for compatibility with 
RealPlayer 5, though. RealPlayer G2 and later can play any clips encoded with 
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these codecs. An “X” in the 5, 4, 3, 2, or 1 column indicates that a clip encoded 
with this codec can be played by that version of RealPlayer. 


Older RealAudio Voice Codecs 
RealAudio Codec 5 4 3 2 1. Sampling Rate 


8 Kbps Voice X |X |X |X |X |8 kHz 


15.2 Kbps Voice X |X |X |X |- |8kHz 


Older RealAudio Mono Music Codecs 


RealAudio Codec 5 4 3 2 1. Sampling Rate 

8 Kbps Music X |X |- |- |- |8 kHz 

12 Kbps Music X |X |- |- |- |8kHz 

16 Kbps Music Low Response X |X |X |- |- |8kHz 

16 Kbps Music Medium Response |X |X |X |- |- | 11.025 kHz 

16 Kbps Music High Response X |X |X |- |- | 11.025 kHz 

32 Kbps Music X |X |- |- |- | 16kHz 

40 Kbps Music X |X |X |- |- | 22.05 kHz 

80 Kbps Music X |X |X |- |- | 44.1 kHz 
Older RealAudio Stereo Music Codecs 

RealAudio Codec 5 4 3 2 1. Sampling Rate 

20 Kbps Stereo Music X |X |X |- |- |8 kHz 

32 Kbps Stereo Music |X |X |- |- |- | 11.025 kHz 

40 Kbps Stereo Music X |X |X |- |- | 16 kHz 

80 Kbps Stereo Music |X |X - |- |32 kHz 


Steps for Streaming Audio 


To produce a great streaming audio clip, you need to use great source material, 
high-quality equipment, and good production practices. This section surveys 
the steps involved in streaming an audio clip. 
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Creating a Streaming Audio Clip 
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> To create a streaming audio clip, follow these basic steps: 


1. Capture audio source. 


You start audio production by capturing audio from a source, such as a 
person speaking into a microphone. You might also start with an audio 
source file from a compact disc, for example. 


For More Information: “Capturing Audio” on page 67 provides 
guidelines for capturing audio. 


2. Optimize the audio source. 


With the audio file digitized in a common file format such as WAV or 
AIFF, you can use a sound editor to optimize the audio file for encoding 
as a streaming clip. When broadcasting live, however, you encode audio 
input directly from the source, optimizing the audio during capture. 
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For More Information: See “Optimizing Audio” on page 69 for 
tips on editing sound. 


3. Encode the streaming audio clip. 


With your digitized file optimized or your live broadcast ready to go, you 
encode your source file in a streaming format, such as RealAudio. When 
you do this, you choose one or several streaming bandwidths based on 
your target audiences. 


For More Information: “Encoding RealAudio with Helix 
Producer” on page 71 provides encoding tips. 


4. Deliver the streaming audio clip. 


When your presentation is ready to go, you make your audio clip or 
broadcast available through your Web site. To combine an audio clip with 
another streaming clip, such as a RealPix clip, you write a SMIL file. 


For More Information: Chapter 8 explains SMIL. See Chapter 21 
for instructions on linking your Web page to a clip or a SMIL 
file. 


Capturing Audio 


A streaming clip reflects the quality of its audio source. Any quality problems 
within the source will affect the streaming clip as well. Because you cannot 
edit a broadcast, live Webcasting introduces several issues beyond those 
involved with delivering on-demand clips. This section will help you capture 
high-quality audio source files, or set up your sound equipment to deliver 
good broadcasts. 


Source Media 


If you plan to stream existing material, start with the best source possible. Use 
the cleanest recording with the least amount of unwanted noise. Compact 
discs (CDs) and digital audio tapes (DATs) are good source media, although 
well-recorded analog sources such as records, reel-to-reel tapes, and chrome 
(type II) cassettes can sound just as good. Try to avoid consumer-grade 
recording media such as Type I cassettes and VHS tapes. 
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Recording Equipment 


Every piece of equipment in the audio chain—microphone, mixer, sound card, 
and so on—affects sound quality. If you intend to provide professional-quality 
audio content, invest in professional-quality audio equipment and software. 
Lesser equipment can add hiss and distortion, degrading sound clarity. 


Shielded Cables 


It is important to use high-quality, shielded cables. Using unshielded cables 
increases the likelihood of introducing line noise and radio frequency 
interference into recordings. Keep audio cables physically separated from 
power cords to minimize the introduction of noise. Also be sure to ground all 
equipment properly. 


Input Levels 


Setting correct input levels is crucial. All audio equipment has a signal-to- 
noise ratio, the ratio between the loudest possible sound the equipment can 
reproduce without distortion and its inherent “noise floor.” Also called 
“clipping,” distortion of this type is audible as a high-frequency crackling 


noise. 


To get the best signal-to-noise ratio, set the input level on each audio device in 
the signal chain so that it uses its full range of available amplitude without 
distortion during the program’s loudest sections. The signal chain typically 
includes a microphone, a mixing desk, a compressor, and a sound card. For 
each piece of equipment, set levels as close as possible to 0 decibels without 
going over that level. 


Check for signal distortion at each point in the signal chain. Perform several 
test runs, and make sure that there are no peaks above maximum amplitude. 
Adjust the levels on your sound card mixer so that the input approaches but 
does not exceed the maximum. Be conservative, though. Levels might 
suddenly increase if, for instance, an interviewee suddenly speaks loudly or a 
crowd at a sports event roars. 


Volume Levels for Live Broadcasts 


When broadcasting live audio streams, it is useful to have a dynamics 
compressor for gain compression (not data compression). This piece of audio 
equipment automatically adjusts the volume level. By providing a consistent 
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volume level, it allows you to “set and forget” the input levels to Helix 
Producer. 


Sampling Rates 


Try to capture sound with a sampling width of 16 bits. RealAudio codecs have 
different sampling rates that produce the best sound, however. If your sound 
card allows it, capture audio content at the optimum sampling rate for the 
codec you intend to use. The RealAudio encoder will convert the file to the 
optimum rate if necessary, but this is recommended only for static files. For 
live broadcasts, use a sound card that supports the optimum rate. This avoids 
the overhead entailed in converting the rate while encoding sound in real 
time. 


For More Information: “RealAudio Codecs” on page 61 lists the 
optimum sampling rates for each codec. 


Tip: You do not need to capture stereo sound if you plan to use 
a mono codec. However, many sound cards simply discard the 
right input channel in mono mode. If you have a mixing desk, 
pan all inputs to the center so that nothing is lost during the 
conversion to mono. 


Optimizing Audio 
If you are not broadcasting audio live, you work with digitized audio source 
files in supported formats such as WAV or AIFF. You then edit the audio files 
to optimize them. To do this, you need to be familiar with the features your 


editing program offers. This section gives you some optimization tips you can 
try with your editing software. 


Tip: Always keep copies of your audio source files. You cannot 
convert RealAudio clips back to their original source formats. 


DC Offset 


DC offset is low-frequency, inaudible noise that results from equipment 
grounding problems. If you don’t remove it, it can skew the results of 
subsequent sound editing. Use your sound editor’s DC Offset function 
immediately after recording a digital audio file. 
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Tip: If your editing program has this option, remove DC offset 
during recording. This eliminates an editing step. 


Normalization 


Set sensible input levels when recording, and then use normalization to 
maximize the levels after recording. Your streaming files sound best when 
your digitized source has the highest possible gain without clipping. Digital 
audio files that do not use their full amplitude range produce low-quality 
streaming clips. If the amplitude range is too low, use your sound editor to 
adjust the range and increase the amplitude. 


Tip: Most sound editors have a Normalize function that 
maximizes levels automatically. Because some systems have 
trouble with files normalized to 100 percent, normalize to 95 
percent of maximum, or to -0.5dB. 


Dynamics Compression 


Normalization maximizes the volume level of the audio file’s loudest sections. 
Consequently, quiet sections may not encode as well. Dynamics compression 
evens out input levels by attenuating (turning down) the input when it rises 
above a specified threshold. Check your audio software for a Compression or 
Dynamics feature. You can control attenuation by specifying a compression 
ratio. This turns down the loudest sections, and you can readjust input levels 
accordingly. 


Tip: For multipurpose dynamics compression, set the 
threshold to -10dB, the ratio to 4:1, and the attack and release 
times to 100ms. Adjust the input level to get approximately 
3dB of compression and an output level of about OdB. 


Equalization 


Equalization (EQ) changes the tone of the incoming signal by “boosting” 
(turning up) or “cutting” (turning down) certain frequencies. Using EQ, you 
can emphasize certain frequencies and cut others that contain noise or 
unwanted sound. EQ can compensate for RealAudio codecs that do not have 
flat frequency responses (that is, codecs for which certain frequencies are not 
as loud after encoding). You can therefore use EQ to make a RealAudio clip 
sound as close as possible to the source recording. 
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Tip: For voice-only content, you can make the file more 
intelligible by cutting frequencies below 100 Hz and carefully 
boosting frequencies in the 1 to 4 kHz range. 


Encoding RealAudio with Helix Producer 


To produce RealAudio clips, you start with audio input from a live source, a 
digitized file, or media such as a tape or CD. You then encode a RealAudio clip 
from this input by using a RealAudio encoding tool. Some sound-editing 
programs can create RealAudio clips. But the most widely used tools for 
encoding RealAudio are Helix Producer Basic (a free product) and Helix 
Producer Plus, which are available from RealNetworks at: 


http://www.realnetworks.com/products/producer/info.html 


Helix Producer on Macintosh accepts the formats widely used on that 
platform, whereas Helix Producer on Windows and Unix supports the formats 
widely used on those platforms. Check the Helix Producer manual for your 
operating system for a list of accepted formats, which may include: 


- Audio Interchange Format (aiff) 
+ Audio (.au) 

+ MPEG-1 (.mpg) 

* QuickTime (.mov) 

+ Sound (.snd) 

+ WAV (.wav) 


When you encode audio clips with Helix Producer, you select the target 
audiences you want to reach, such as 56 Kbps modem users. You also indicate 
the audio type, whether voice or music. Helix Producer then determines which 
RealAudio codecs are best to use. Helix Producer uses SureStream technology 
to encode the RealAudio clip so that it streams well for all your bandwidth 
choices, requiring only a few seconds of preroll when RealOne Player users 
request the clip. 


For More Information: Refer to the Helix Producer user’s 
guide or online help for step-by-step instructions for 
encoding RealAudio. 
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Note: RealAudio encoding tools other than Helix Producer 
may not include all the features described in the following 
sections. 


RealAudio in Multiclip Presentations 


If your RealAudio clip will be played along with another clip, you may need to 
change Helix Producer’s default codec selection by adjusting the RealAudio 
target audience settings. Encoding mono music for 28.8 Kbps modems usually 
entails a 20 Kbps codec, for example, leaving no bandwidth for the second 
clip. Helix Producer has a set of multimedia defaults, though, that lower the 
clip’s bandwidth. With these defaults turned on, Helix Producer encodes the 
mono music clip at 8 Kbps, leaving 12 Kbps of bandwidth for the second clip. 


CHAPTER 


4 


VIDEO PRODUCTION 


RealNetworks introduced RealVideo with RealPlayer 4, making 
streaming video available over the Internet. This chapter covers 
RealVideo production techniques, providing tips for capturing high- 
quality video, working with digitized video source files, and using 
Helix Producer to encode your clips. 


Understanding RealVideo 


A video consists of two parts: the visual track and the soundtrack. In a 
RealVideo clip, the soundtrack is encoded with RealAudio codecs, and the 
visual track is encoded with a RealVideo codec. Both tracks are packaged in a 
RealVideo clip that, like a RealAudio clip, uses the file extension .rm. This 
section explains how RealVideo encodes a source video for streaming. This 
information will help you produce high-quality streaming clips. 


Note: Keep in mind that everything discussed about RealAudio 
clips in Chapter 3 also applies to the soundtracks in RealVideo 
clips. 


RealVideo Bandwidth Characteristics 


Because RealVideo uses RealAudio to encode a video’s soundtrack, a chunk of 
the clip’s bandwidth first goes toward the audio. The visual track is then 
squeezed into the bandwidth that’s left. For 56 Kbps modems, for example, 
RealVideo clips stream at 34 Kbps, leaving 22 Kbps of modem bandwidth for 
overhead. How much bandwidth the visual track gets depends on how the 
audio is encoded. With an 8 Kbps RealAudio voice codec for the soundtrack, 
the visual track gets 26 Kbps. With a 16 Kbps music codec, though, the visual 
track gets just 18 Kbps. 
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Possible Audio and Visual Tracks in a 20 Kbps RealVideo Clip 


56 Kbps 


22 K Overhead 22 K Overhead 


8 K Audio 
16 K Audio 


26 K Visual 


18 K Visual 


At low bandwidths, how you encode the soundtrack can affect how the visual 
track looks. RealAudio music codecs typically consume more bandwidth than 
do voice codecs. Music’s greater frequency range requires more data than does 
speech, so a music soundtrack consumes more bandwidth than a spoken one. 
A video with an audio narration might therefore look better than one 
accompanied by music, as there would be more bandwidth available for the 
visual track. 


At higher streaming speeds, the soundtrack uses proportionally less of the 
clip’s bandwidth, so differences in soundtrack encoding affect visual quality 
less. At speeds above 100 Kbps, you get high-quality sound that uses no more 
than a quarter of the clip’s streaming bandwidth. The following table lists the 
standard RealVideo target audiences used in Helix Producer, giving the clip 


streaming speeds and the RealAudio codecs used for the soundtracks, broken 
out by audio type. 


Audio Bit Rates for RealVideo Clips 
RealAudio Rate 


Voiceand Mono Stereo 
Target Audience Clip Speed Voice Only Music Music Music 
28.8 Kbps modem 6.5 Kbps 

6.5 Kbps 8 Kbps 8 Kbps 
56 Kbps modem 
8.5 Kbps 

64 Kbps single ISDN 8.5 Kbps 11 Kbps | 11 Kbps 
112 Kbps dual ISDN 16 Kbps 20 Kbps |16 Kbps _ | 20 Kbps 


(Table Page 1 of 2) 
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Audio Bit Rates for RealVideo Clips (continued) 
RealAudio Rate 


Voiceand Mono Stereo 
Target Audience Clip Speed Voice Only Music Music Music 


Corporate LAN 32 Kbps |32 Kbps | 32 Kbps 
256 Kbps DSL/cable 44 Kbps |44Kbps_ | 44 Kbps 
384 Kbps DSL/cable 64 Kbps 
512 Kbps DSL/cable 
768 Kbps DSL/cable 


32 Kbps 


64 Kbps 64 Kbps | 64 Kbps 


96 Kbps 


(Table Page 2 of 2) 


Note: With SureStream technology, a single RealVideo clip can 
stream at many different speeds. For the basics of SureStream, 
see “SureStream RealAudio and RealVideo” on page 50. 


RealVideo Frame Rates 


Like RealAudio, RealVideo is “lossy,” meaning that it throws out nonessential 
video data when encoding a clip. One way that RealVideo squeezes down clip 
sizes is by reducing the video’s frame rate. The higher the frame rate, the 
smoother the motion: 


- The standard frame rate for full-motion video is 24 to 30 frames per 
second (fps). At this speed, the human eye perceives movement as 
continuous—a phenomenon known as persistence of vision. 


- Acommon rate for streaming video that approximates full-motion video 
is 15 fps. To most people, a 15 fps video flows smoothly, though not quite 
as fluidly as one at a higher rate. 


- Below 15 fps, a video looks jerky. 
+ Below 7 fps, a video looks very jerky. 
- Below 3 fps, a video essentially becomes a slideshow. 


Most source videos start out at 15 to 30 fps. During encoding, RealVideo 
adjusts this frame rate downward as necessary, keeping the rate up in high- 
action scenes, reducing it in slow ones. Thus, your encoded clip will not have 
just one frame rate, but a mix of frame rates that varies with its content. If you 
follow good production practices, your clips will typically stream over slow- to 
medium-speed connections at 7 to 15 fps. At higher speeds, you'll get 15 to 30 
fps. Many factors, though, affect a RealVideo clip’s frame rate: 
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- The video’s dimensions greatly affect frame rate. If you use too large of a 
window for your target bandwidth, you will not get a high frame rate. For 
more information, see “RealVideo Dimensions” on page 77. 


- RealVideo 9 provides video quality superior to that produced by older 
RealVideo codecs. Using an older codec may result in a lower frame rate. 


+ Visually complex videos that show many objects moving across the screen 
simultaneously are hard to encode and may result in too low a frame rate. 


+ Helix Producer gives you an option for smoother motion. Choosing this 
option raises the clip’s overall frame rate and reduces visual quality, 
whereas choosing the option for better image quality lowers the frame 
rate. 


+ Ina video that has a mix of fast and slow scenes, variable bit-rate encoding 
(VBR) and two-pass encoding generally help the fast scenes achieve a 
higher frame rate. See “RealVideo Options” on page 89 for more 
information. 


+ When encoding with Helix Producer Plus, you can lower the bit rate of the 
RealAudio codecs used for a given clip. This gives more bandwidth to the 
visual track, helping to raise the frame rate. 


+ Scalable Video Technology (SVT) enables RealOne Player to lower the 
frame rate as necessary during playback to lighten a computer’s CPU load. 
For more information, see “Scalable Video Technology” on page 80. 


RealVideo Clarity 


In addition to changing its frame rate, RealVideo can reduce a clip’s streaming 
size by throwing out pixel data. A video stores information about each pixel in 
the frame. RealVideo, on the other hand, stores data for pixel groups. When 
bandwidth is tight, RealVideo shoehorns pixels with slightly different RGB 
values into the same group. These pixels then look identical rather than nearly 
identical. This may result in a loss of detail if compression is too high. The 
following illustration compares a smooth video with one that has lost detail 
through too much compression. 
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Smooth and Distorted Video 


By using good production practices as described in this chapter, you can help 
keep the video’s clarity intact during encoding. Also note the following points: 


+ The video’s dimensions affect visual clarity. If you use too large of a 
window for your target bandwidth, visual clarity may suffer. For more 
information, see “RealVideo Dimensions” on page 77. 


+ When you encode with Helix Producer, you can choose an option for 
better image quality. The video may be jerkier, though, because increasing 
the pixel data reduces the frame rate. 


- A video with relatively stationary subjects (“talking heads”) will have 
better visual quality than a video with rapid scene changes and a lot of 
movement. 


- If you plan to launch a video in double- or full-screen mode as described 
in “Controlling How a Presentation Initially Displays” on page 514, boost 
video clarity as much as possible during production and encoding. 
RealOne Player enlarges the clip by duplicating its pixels, which magnifies 
any defects. 


RealVideo Dimensions 


The following table lists four common RealVideo clip dimensions that 
maintain the 4:3 aspect ratio used in television. For each clip size, the table 
indicates the general playback quality you'll get when streaming a RealVideo 9 
clip to various target audiences. “Excellent” video quality means few visual 
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artifacts and a frame rate that results in consistently smooth playback. Lower- 
quality video playback means more artifacts and a lower frame rate. 


RealVideo Quality at Different Dimensions and Bandwidths 
Video Quality for Dimensions in Pixels 
Target Audience Clip Speed 176x132 240x180 320x240 640x480 
28.8 Kbps modem 


Fair 
56 Kbps modem Good Poor 
64 Kbps single ISDN Good 
112 Kbps dual ISDN Fair 
Excellent |-——_—_——- 
Corporate LAN Good 
256 Kbps DSL/cable Excellent | Excellent 
384 Kbps DSL/cable Excellent 


512 Kbps DSL/cable 


The table shows that when streaming larger videos, you get good to excellent 
quality only at higher connection speeds. If you plan to stream clips over 
modems, you can first encode your clip at 320 by 240 pixels to test its quality. 
If you want better quality, shrink the video dimensions with your editing 
software or with Helix Producer during encoding. 


Tip: When resizing a video with Helix Producer, setting the 
RealVideo preferences to high-quality resize rather than a fast 
resize yields better results. 


Different Clip Dimensions for Different Bandwidths 


When you want to encode a single video for both low-speed and high-speed 
connections, you need to decide what video dimensions to use. Although with 
SureStream technology you can easily create a single RealVideo clip that 
streams at many bandwidths, using too large a clip results in low frame rates 
for viewers with dial-up modems. Therefore, you may want to use small video 
dimensions to reach the widest audience. High-speed viewers, however, will 
not receive the benefit of their hefty bandwidth. 


You can resolve this dilemma by creating two or more versions of your video, 
each with different dimensions. You can use your video editing software to do 
this, or use Helix Producer to resize or crop the video during encoding. Then 
encode each video for a few different streaming speeds. You can make the clips 
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available through separate links, or use a SMIL <switch> tag to let RealOne 
Player choose which version to play. 


For More Information: The basics of the <switch> tag are in 
“Understanding Switching” on page 439. For a sample <switch> 
tag, see “Different Video Sizes Chosen Automatically” on page 
457. 


RealVideo Codecs 


RealVideo 9 is the standard RealVideo codec, but you can also encode with 
older RealVideo codecs. The codec you use encodes all of a clip’s SureStream 
streams. You cannot encode half the streams with the RealVideo 9 codec, for 
example, and the other half with the RealVideo 8 codec. 


RealVideo 9 Codec 


RealVideo 9 improves on RealVideo 8 with higher compression and improved 
visual quality. RealOne Player and later can play RealVideo 9 clips. Older 
versions of RealPlayer are prompted to autoupdate to RealOne Player. 
RealNetworks recommends using this codec unless you need faster encoding 
performance during broadcasts, or you need to stream video to earlier versions 
of RealPlayer. 


RealVideo 8 Codec 


The RealVideo 8 codec results in visual quality markedly superior to that 
produced by the RealVideo G2 codecs. It requires more processing power, 
though, so encoding a clip with it takes longer than encoding the clip with a 
RealVideo G2 codec. RealPlayer 8 and later can play RealVideo 8 clips. Earlier 
versions of RealPlayer are prompted to autoupdate to RealOne Player. 


RealVideo G2 Codecs 


The RealVideo G2 codecs are older codecs used by RealProducer G2 and 
RealProducer 7. These codecs encode video clips faster than later RealVideo 
codecs do, but their visual quality is poorer. For a given streaming speed, using 
an older RealVideo codec rather than RealVideo 9 or RealVideo 8 results in 
either a reduced frame rate or diminished visual quality at the same frame 
rate. Use one of the following RealVideo G2 codecs for faster encoding during 
broadcasts or if you need to stream video to versions of RealPlayer that cannot 
upgrade to RealOne Player: 
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- RealVideo G2 with SVT 


The RealVideo G2 with SVT codec is compatible with RealPlayer G2 
Update 1 (version 6.0.6) or later. RealPlayers with lower version numbers 
are prompted to autoupdate to the latest version of RealOne Player before 
viewing the clip. 


- RealVideo G2 


The RealVideo G2 codec without SVT is compatible with RealPlayer G2 
and later. It is no longer included with the latest version of Helix 
Producer. 


Scalable Video Technology 


RealVideo G2 with SVT and later codecs include Scalable Video Technology 
(SVT), which scales down frame rates when clips play on slower computers. 
RealVideo’s variable frame rate means that one scene may be encoded at 7 fps, 
whereas another one is encoded at 15 fps. High frame rates take a lot of 
processing power to decompress. Although fast PCs handle high frame rates 
well, slower PCs may have trouble. With SVT, RealOne Player can lower the 
frame rate “on the fly” to keep a PC’s CPU from sputtering. So although a 
given scene is encoded at 15 fps, it may play on some RealOne Players at 8 fps 
if those computers lack the power to decompress 15 fps video clips. 


Steps for Streaming Video 


When producing a video clip, you should choose the best source material and 
best equipment possible. The goal throughout the video production process is 
to get optimum video quality for each streaming speed. 
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Creating Video Clips 


&X ho 
Digitized Optimized 
Raw Video bd Video 
(.avi, .mov, .mpeg) Video 
Editing 
Station 
N od 
oo 
oo 
oo 
Captured a Encoded 
Video Encoder Video Clip 


Streamed 


Video Player 


> The following steps summarize how to create a video clip: 


1. Capture the video content. 


To start video production, you capture the source video by shooting a 
scene with a video camera, for example, or gathering prerecorded content 
from a tape, satellite, laserdisc, or other source. 


For More Information: “Recording Video” on page 82 provides 
guidelines for shooting a video. 


2. Digitize and edit the video file. 


You next digitize the video to convert it to a standard file format, such as 
AVI or QuickTime. With your preferred video editing software, you can 
then edit the video as necessary. If you are broadcasting live, however, you 
encode the streaming video directly from the source. 


81 


RealNetworks Production Guide 


For More Information: See “Digitizing Video” on page 84 for tips 
on video editing. 


3. Encode the streaming video clip. 


With your digitized file optimized or your live broadcast ready to go, you 
encode your source as a streaming clip, such as RealVideo. When you do 
this, you target a network bandwidth or a set of bandwidths. 


For More Information: “Encoding RealVideo with Helix 
Producer” on page 86 provides encoding tips. 


4. Deliver the streaming video. 


With your presentation ready to go, you make your video clip or broadcast 
available through your Web site. If you are combining video with another 
streaming clip, you write a SMIL file that assembles the pieces. 


For More Information: Chapter 8 explains how to create a SMIL 
file. See Chapter 21 for instructions on linking your Web page 
to a video clip or a SMIL file. 


Recording Video 


Read this section carefully if you intend to shoot a new video rather than use 
existing video content. Because video loses image quality if it’s highly 
compressed, always start with the best video source available. 


For More Information: For pointers on recording audio, see 
“Capturing Audio” on page 67. 


Source Media Quality 


Whether you shoot a video yourself or digitize existing material, start with a 
high-quality video media. The following are common video formats, listed in 
order of descending quality: 


1. Betacam SP, also known simply as Beta. This format is common among 
video production professionals. 


2. DV, miniDV, DVCam, or DVCPro. 
3. Super-VHS (S-VHS) or HI-8mm. 
4. VHS, 8mm. 
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Video Staging 


Consider the video’s final frame size before you shoot the first frame. 
Streaming over 56 Kbps modems requires a small video window, so you need 
to frame important visual elements well. For recommended clip dimensions, 
see “RealVideo Frame Rates” on page 75. 


Scene Changes and Movement 


The fewer things that change from frame to frame, the sharper the image will 
appear in a low-bandwidth video. You can do the following to cut down on 
unnecessary movement: 


- Use a mounted camera rather than hand-held one. This greatly reduces 
the movement you inadvertently introduce into the scene when recording. 


+ Don’t have a rapidly moving object fill the entire frame. But you don’t 
want to pull the camera back too far either. You need to find a happy 
medium between close-ups and panoramic shots. 


Of course, you don’t want to eliminate all dynamic elements. When you do 
include rapid movement, allow enough time for objects to resolve. Because of 
low frame rates and high compression, objects coming to rest may appear 
blurry at first. If you have a dialog box popping up on a computer screen, for 
example, have the box remain stationary for a few seconds so that the image 
resolves. 


Tip: RealPix makes a great companion to RealVideo. When 
presenting a lecture, for example, use RealVideo to show the 
speaker, and use a RealPix slideshow to present visual aids such 
as information written on a blackboard. For more on RealPix, 
see Chapter 7. 


Colors and Lighting 


Bright lighting at a constant exposure keeps the foreground detail crisp. Use 
uniformly dark colors for backgrounds, and uniformly light colors (but not 
whites) for clothing. Complex textures such as paisley and stripes degrade the 
final image quality with unwanted visual effects. 
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Digitizing Video 
If you are not broadcasting RealVideo streams live, you digitize the source 
video on your computer or video editing station. You can then edit the file 
with your preferred editing software before encoding it as a RealVideo clip. 
This section provides tips for digitizing video. 


Tip: Always keep copies of the video source files. You cannot 
convert RealVideo clips back to their original source formats 
or any other streaming formats. 


S-Video Output 


Video playback devices commonly have at least two common output types— 
S-video and composite. Use S-video, as it produces better results. 


Color Depth 


Always use 24-bit color. Lower color resolution results in poor clips. 


Digitized Video Formats 


It is better to work with uncompressed formats. Otherwise, you compress the 
source once when you digitize it and again when you encode it as RealVideo. 
This double compression can decrease the image quality. Use a compressed 
source format only if your RealVideo encoding tool supports the file as input. 
You can use compressed AVI files as long as the computer used to encode 
RealVideo clips has the same Video for Windows driver used to compress the 
AVI file. 


Video Capture Frame Rates 


Capture the video content at 15 frames per second (fps) if your clip will stream 
at less than 100 Kbps. For higher-speed streaming, capture it at 30 fps. Because 
a RealVideo clip’s frame rate varies, some scenes may be encoded at less than 
the capture rate depending on bandwidth constraints. SVT enables RealOne 
Player to lower the frame rate on computers that have low processing power, 
ensuring that high frame rates will not overburden slow computers. 


For More Information: For more information on SVT, see 
“Scalable Video Technology” on page 80. 
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Video Capture Screen Sizes 


Unless you are short on disk space or your video capture card recommends 
different dimensions, capture video at 320 pixels wide by 240 pixels high. You 
can capture full-motion video at the full-screen size of 640 by 480 pixels if all 
of the following are true: 


+ Your clips will stream at speeds higher than 100 Kbps. 
- Your encoded clips will be larger than 320 by 240 pixels. 


+ You have a video workstation capable of digitizing full-motion, full-screen 
video. Standard PCs typically cannot handle this large a load. 


Using your editing software or Helix Producer, you can reduce the RealVideo 
clip dimensions if necessary. For recommended clip sizes, see “RealVideo 
Dimensions” on page 77. 


Computer Speed and Disk Space 


Because video capture places a large burden on a computer’s CPU and hard 
drive, use the fastest computer you have available. To avoid dropping frames 
during video capture, use a hard drive specially made for audio and video 
work. On Windows computers, you can use any video capture card that 
supports Video for Windows. 


Use the following formula to calculate the approximate size in megabytes of a 
digitized video file: 
(pixel width) x (pixel height) x (color bit depth) x (fps) x (duration in seconds) 


8,000,000 


Suppose you want to capture a three-minute video at 15 frames per second, 
with 24-bit color, in a window that is 320 by 240 pixels. As you can see from 
the following equation, your digitized source file would be approximately 622 
MB: 


(320) x (240) x (24) x (15) x (180) / 8,000,000 = 622 Megabytes 


If necessary, you can conserve disk space by decreasing the clip dimensions or 
lowering the frame rate, or both. 


Video Source File Size Limit 


The Macintosh and some Windows file systems limit a single file to 2 GB 
(2048 MB) in size. At a 320-by-240 size and 15 fps, this translates to about 9.5 
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minutes of video. Certain video production programs support the OpenDML 
(AVI 2.0) standard, which allows the creation of files larger than 2 GB. Helix 
Producer may be able to accept a video source file larger than 2 GB as input, 
depending on the production software used to create the file. 


If you plan to produce long videos or videos with large dimensions, check 
whether or not your video production software is limited to a 2 GB output file 
size. If it is not limited to 2 GB, create a video file larger than 2 GB and test to 
determine if Helix Producer can accept the file as input. 


For More Information: Search RealNetworks’ Knowledge Base 
for “AVI limit” at http://service.real.com/kb/index.html. 


Tip: If you are limited to 2 GB for the video source file and you 
need to produce a larger video, you can create separate video 
source files (each 2 GB or smaller) and encode them as separate 
RealVideo clips. Then, merge the clips using Helix Producer’s 
editing tools. See the Helix Producer User’s Guide for more 
information. 


Encoding RealVideo with Helix Producer 
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To produce RealVideo clips, you start with video input from a live source, a 
digitized file, or media such as a tape or CD. You then encode a RealVideo clip 
from this input using a RealVideo encoding tool. The most widely used tools 
for encoding RealVideo are Helix Producer Basic (a free product) and Helix 
Producer Plus, which are available from RealNetworks at: 


http://www.realnetworks.com/products/producer/info.html 


Helix Producer on Macintosh accepts the input formats widely used on that 
platform, whereas Helix Producer on Windows or Unix supports the formats 
widely used on those platforms. Check the Helix Producer manual for your 
operating system for a list of accepted formats, which may include: 


+ AVI (.avi), uncompressed (recommended) or compressed 
+ MPEG-1 (.mpg) 
* QuickTime (.mov), uncompressed (recommended) or compressed 


When you encode RealVideo clips, you choose a bandwidth target or set of 
targets, then set parameters such as audio type (voice or music) and an 
emphasis on either smooth motion or sharp images. Helix Producer then 
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decides which RealAudio codecs are best to use for the soundtrack. It uses 
SureStream technology to encode the RealVideo clip for all your bandwidth 
choices, ensuring that each stream requires only a few seconds of preroll. 


For More Information: Refer to the Helix Producer manual or 
online help for step-by-step instructions for encoding clips. 


Note: RealVideo encoding tools other than Helix Producer may 
not include all the features described in the following sections. 


RealVideo Streaming Speeds 


For all practical purposes, RealVideo’s streaming bit rate is infinitely scalable. 
You can encode RealVideo at any speed you want, from 20 Kbps to hundreds 
or thousands of Kilobits per second. Plus you can encode precisely at any 
bandwidth you choose, such as 89 Kbps, 117 Kbps, 575 Kbps, 1.5 Mbps, and so 
on. With Helix Producer Plus, you do this by adjusting RealVideo’s target 
audience settings. 


If your RealVideo clip will play in parallel with another clip, you may need to 
lower RealVideo’s bit rate for each target audience. This way, the clip does not 
consume all of a connection’s bandwidth. For a 56 Kbps modem, for example, 
Helix Producer standardly encodes the clip to stream at 34 Kbps. Using the 
RealVideo target audience settings, you can lower this value to 20 Kbps, for 
example, leaving 14 Kbps free for another clip. 


Whenever you lower RealVideo speed, the new bit rate includes the rate of the 
RealAudio codec used for the soundtrack. If you use a 32 Kbps RealAudio 
codec and set a total RealVideo bit rate of 36 Kbps, you will not have much 
bandwidth left for the visuals (maybe a frame every few seconds). You'll need 
to select a lower-bandwidth RealAudio codec. 


There are no strict rules for the ratio of soundtrack bandwidth to total 
RealVideo bandwidth. The ratio depends entirely on whether you want to 
emphasize the audio track or the visuals. RealVideo normally allots no more 
than 25 percent of the total bandwidth to the soundtrack because the visual 
information contains much more data. At bandwidths of several hundred 
Kilobits per second, you can use considerably less bandwidth for the 
soundtrack in relation to the visual track. 
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RealVideo Filters 


Helix Producer’s preferences include filtering options you can use when 
encoding RealVideo clips. These filters remove artifacts that appear in the 
encoded clips because of the methods used to create the source video. 


Noise Filters 


Noise distortion is similar to the “snow” that often shows up on TV screens as 
a result of signals received over an antenna. Helix Producer has low and high 
noise filters you can use if your source video clip has a little noise or a lot of 
noise, respectively. The best way to eliminate noise, though, is to follow good 
production practices, as described in “Recording Video” on page 82. 


Resizing Filters 


When you resize a RealVideo clip with Helix Producer, you can use a resizing 
filter that performs either a fast resize or a high-quality resize. These resizing 
options affect the source video only when you make the clip smaller. They tell 
Helix Producer to throw out video data by using either a quick method (fast 
resize) or a complex analysis (high-quality resize). A high-quality resize results 
in a superior image, but it also lengthens the encoding time. 


Inverse-Telecine Filter 


The Inverse-Telecine filter is for cinematic film that was transferred to NTSC 
video. It has no effect on PAL video. Film is usually photographed at 24 frames 
per second (fps), and the film-to-video conversion (called “telecine”) 
duplicates some frames to achieve the NTSC standard of 30 fps. To strip out 
redundant frames, use the inverse-telecine filter when encoding NTSC video 
that was transferred from film and has a frame rate of 25 to 30 fps. 


De-Interlace Filter 


The de-interlace filter removes jaggedness from interlaced video. It is useful 
only for interlaced source video that is at least 240 lines high. Typical source 
video used for television is 480 lines high. If you digitize the video with a video 
capture card that captures at 240 lines or fewer, the card throws out either the 
odd or the even lines, de-interlacing the video itself. 
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RealVideo Options 


The Helix Producer preferences include several RealVideo encoding options 
that affect the quality of RealVideo clips by modifying Helix Producer’s 
encoding methods. 


Variable Bit Rate Encoding 


Variable bit rate (VBR) encoding is optional. It gives more bandwidth to scenes 
that are hard to compress, and less to scenes that are easy to compress. It can 
also keep video quality high by taking advantage of some of the streaming 
bandwidth reserved for network overhead. VBR encoding generally provides 
video quality superior to that achieved through constant bit rate (CBR) 
encoding, making the most difference in videos that have a mix of high- and 
low-action scenes. VBR encoding is not used with SureStream, and RealVideo 
VBR clips used the file extension .rmvb. 


Two-Pass Encoding 


With two-pass encoding, Helix Producer runs through the source video once 
to gather information. It then makes a second pass to encode the RealVideo 
streams. Two-pass encoding helps the most with variable bit rate (VBR) 
encoding. When you use two-pass encoding with VBR, Helix Producer 
analyzes the entire source video first to determine how best to vary the 
playback bit rate. When you don’t use it, Helix Producer analyzes small 
sections of the source video during encoding, creating a string of VBR sections 
within the clip. 


Loss Protection 


Helix Producer’s loss-protection feature adds error-correction data to 
RealVideo streams, helping them maintain quality in lossy environments. 
Helix Producer adds as much error-correction data as it can without lessening 
the video quality. Although you'll get more benefit from this feature when 
streaming across the Internet rather than over an intranet, it is useful to turn 
loss protection on for all encoded content. 


89 


90 


RealNetworks Production Guide 


CHAPTER 


FLASH ANIMATION 


Using Macromedia Flash, you can stream animations on the World 
Wide Web. Delivered by Helix Universal Server, Flash clips can create 
visually arresting animations that play in RealOne Player. This 
chapter provides guidelines for creating and optimizing Flash clips 
that stream to RealOne Player. For instructions on developing Flash 


animation, refer to the Flash user’s guide. 


For More Information: Learn more about Flash from 
Macromedia’s Web site at http://www.macromedia.com/ 
software/flash. 


Understanding Flash 


Flash is well-suited for linear presentations that have a continuous audio 
track and animated images synchronized along a timeline. Such presentations 
could include: 


- demonstrations, training courses, and product overviews 
+ full-length cartoons for entertainment and education 
+ product advertisements 
+ movie trailers 
+ Karaoke 
With Flash commands, you can build interactive icons and forms for: 
* electronic commerce 
* on-screen navigation 
+ Internet radio tuners 


+ e-mail registration 
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This section explains how Flash works with RealOne Player. This knowledge 
will help you produce high-quality streaming animation. 


Software Versions for Flash 


Streaming Flash version 3 or 4 to RealOne Player requires Helix Universal 
Server 8 or later. Earlier versions of Helix Universal Server stream only Flash 2. 
RealPlayer 8 or RealOne Player is required to play Flash 3 or 4 clips. RealPlayer 
G2 or 7 will autoupdate to the latest RealOne Player release when it 
encounters a Flash 3 or 4 clip. 


RealOne Player does not support the Flash 5 Player format. You can develop 
your animation with Flash S, or a later version of that program, but your 
exported Flash Player clip must be in the Flash 2, 3, or 4 format. Note that the 
Flash 5 program can automatically export and tune your clips in the Flash 4 
format for streaming to RealOne Player. 


Flash in the Three-Pane Environment 


This chapter describes techniques for creating streaming Flash presentations 
that play in RealOne Player’s media playback pane. RealOne Player includes 
support for Flash animation by default, so any viewer with RealOne Player will 
be able to view your Flash animation without downloading a plug-in, as long 
as the animation streams to the media playback pane. 


Flash animation clips can also display within an HTML page shown in the 
media browser or related info pane, however. In those cases, the Flash 
animation is rendered by the Flash plug-in for the browser application used by 
RealOne Player (Internet Explorer for RealOne Player on Windows). Playing an 
animation in a RealOne Player HTML pane therefore requires a viewer to 
download and install the Flash browser plug-in if it’s missing. 


For More Information: For more on the three-pane environment, 
see “Step 2: Learn the RealOne Player Interface” on page 29. 


Flash Bandwidth Characteristics 


As with any streaming clip, you develop a Flash clip with a target audience 
bandwidth in mind. The table “Maximum Streaming Rates” on page 47 lists 
the highest rate at which your Flash clip should stream for various network 
connection speeds. Keep in mind, too, that if your Flash clip streams along 
with other clips, the combined streaming speed of all the clips should not 
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exceed the maximum speed for the target audience. This helps ensure that 
your presentation does not rebuffer frequently. 


Because most Internet users have 28.8 or 56 Kbps modems, RealNetworks 
recommends that you target dial-up modem audiences. Fortunately, Flash 
clips streamed over a 28.8 Kbps modems can have a visual impact comparable 
to that of a video streaming at a significantly higher bit rate. This is because 
Flash clips transmit vector information rendered by the viewers’ computers. 
Hence, the quality of Flash animation depends more on a computer's CPU 
and graphics capabilities than on the amount of streamed data. 


Because it is vector-based, Flash does not consume bandwidth evenly. When a 
scene starts, for example, its groups and symbols are streamed, requiring a lot 
of data transfer. After that, only lightweight instructions for manipulating 
groups and symbols are needed. This following figure shows a Flash clip that 
targets a streaming speed of 12 Kbps. At 2 and 7 seconds into the clip’s 
timeline, bandwidth use spikes because the clip needs more than 12 Kilobits 
of data to change scenes or to introduce new objects in a key frame. 


Bandwidth Use in an Untuned Flash Clip 


Untuned 

f\ Clip 

Streaming 
Speed 
<4 Target 


<4 Actual 
Bandwidth 
Use 


Time (Seconds) 


If it encounters spikes, RealOne Player buffers the data, delaying playback 
until all of the necessary data has arrived. For your clip to stream well, you 
must eliminate spikes by tuning the finished clip. Tuning the clip also sets the 
clip’s streaming bit rate and preroll. The Flash 5 program can export and tune 
a clip automatically. Or, you can tune an exported clip manually with the 
Flash tuner. The tuner is included in the utilities folder of the zipped HTML 
version of this manual. 
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Bandwidth Use in a Tuned Flash Clip 


Bit Rate (Kb) Tuned 


Streaming 
Speed 
4 Target 


he Actual 
Bandwidth 
Use 


Time (Seconds) 


For More Information: See “How to Download This Guide to 
Your Computer” on page 12 for instructions on getting a local 
copy of this guide. 


Tip: You will not know how well your clip streams until you 
tune it. Because you may need to revise the animation to make 
the clip stream well for your chosen audience, export and tune 
the animation frequently as you develop it. 


Flash Clip Size 


Tuning your Flash clip guarantees that it streams at your chosen bit rate. If 
your animation is too complex, however, tuning it to a low bit rate may cause 
an unacceptably high preroll in RealOne Player. The best way to guarantee a 
low preroll is to keep the ratio of clip size to clip length low. The following are 
tips for keeping the Flash clip size as small as possible as you develop your 
animation: 


+ Reduce key frames. 


Excessive key frame changes increase bandwidth consumption. Minimize 
the number of key frames and simplify the objects within key frames. 


- Use symbols instead of groups. 


Flash stores a symbol once and can then refer to it at any time, with each 
reference adding little to the file size. However, it stores a group definition 
each time the group is used. Using a group three times, for example, stores 
the same data in the file three times. Using symbols instead of groups can 
therefore reduce file size significantly. 
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- Simplify elements. 


Simplify the elements that you draw or import into Flash. Under 
Modify>Curves, use the Smooth and Straighten commands on lines and 
curves to strip away unneeded point and path information. This reduces 
the amount of data stored for each element. Use Optimize to optimize the 
data reduction while maintaining acceptable screen appearance. Because 
screen resolution is lower than print resolution, you can eliminate minute 
details without compromising appearance. 


¢ Do not include event sound. 


As described in “Adding Audio to Flash” on page 96, RealOne Player does 
not support event sounds. Including event sounds in the exported Flash 
Player clip wastes bandwidth. Either remove event sounds from the source 
Flash file (.fla) or export the Flash Player clip (.swf) without sound. 


- Adjust JPEG quality when exporting. 


If your animation has imported graphics, set the JPEG quality to no 
greater than 50—possibly as low as 30—when exporting the .fla file to a 
.swf clip. 


Flash CPU Use 


Bandwidth use is not the only consideration when developing Flash 
animation. Because it is vector-based, Flash performs complex calculations on 
the user’s computer to display the animation. Operations that require many 
calculations in addition to the computer’s normal load may adversely affect 
playback. Newer computers typically have processors that are fast enough to 
handle Flash and other clips streamed in parallel, but older computers may 
not have this capacity. To support the widest audience possible, follow these 
recommendations to reduce Flash CPU requirements: 


¢ Reduce the frame rate. 


Macromedia recommends a Flash frame rate of 12 frames per second 
(fps). If you combine a Flash clip with another clip that needs 
considerable processing power, though, you may need to lower this frame 
rate to accommodate slow computers. Try 9 fps or 7 fps when combining 
Flash with RealAudio, for example. These rates provide acceptably smooth 
motion without overburdening most processors. 
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+ Optimize tweening. 


The tweening process interpolates the motion between key frames. 
Interpolating multiple objects and color effects at the same time will 
adversely affect playback. Other actions related to tweening that slow 
down playback include changing large areas of the screen between frames 
and using gradient fills. 


+ Decrease the number and size of objects moving simultaneously. 


RealOne Player must redraw areas where action occurs, thus consuming 
CPU power. To minimize this, localize tweening to a small portion of the 
screen so that the entire screen does not have to be redrawn. This way, file 
size remains the same, but only one part of the screen is redrawn. 


Adding Audio to Flash 


RealOne Player does not support audio embedded in a Flash clip, so it will not 
play event sounds for mouseovers and button clicks, for example. You can 
include sound for a Flash clip only by exporting the soundtrack and encoding 
it as a RealAudio clip that plays in parallel with Flash. Therefore, audio tracks 
are beneficial primarily for linear clips such as a cartoons, rather than for 
interactive applications. 


Tip: Flash provides different methods for incorporating sound 
into an animation. Use the stream synchronization setting. 


A Flash Soundtrack Uses a Separate RealAudio Clip 


Nn | 
X Animation RealNetworks Juve: 
Only (.swf) Flash Tuner Flash Clip 4 
(.swf) 
Flash mM 5 a SMIL Player 
File (.fla) oo File (.smil) 

oo 
oo 

Soundtrack Audio 

(.wav, .mov) Encoder Clip 


To create separate animation and audio clips, you first synchronize your 
animation with an imported sound file, such as a WAV or AIFF file. You then 
export two files: 
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- A Flash Player clip that contains no sound. 


- A soundtrack that you encode as a RealAudio clip. 


Using SMIL, you synchronize both clips for streaming. The Flash 5 program 
can create a SMIL file and export your soundtrack as a RealAudio clip 
automatically. If you use an earlier version of Flash, you need to export the 
soundtrack manually, encode it as a RealAudio clip, and write the SMIL file. 
“Streaming a Flash Clip” on page 105 summarizes this exporting process. 


Bandwidth Division Between Flash and RealAudio 


When you export and encode your Flash soundtrack as a SureStream 
RealAudio clip, all viewers get the same Flash clip, but they get different 
RealAudio streams depending on their network connection speeds. For any 
network connection, determining your Flash and RealAudio clip speeds is a 


two-step process: 


1. Decide which RealAudio codecs to use to encode the soundtrack. All 
codecs are listed in “RealAudio Codecs” on page 61. 


2. For your lowest-speed target audience, subtract the lowest RealAudio 


streaming speed from the target’s maximum streaming speed to get the 
Flash clip’s maximum streaming speed. 


For More Information: The table “Maximum Streaming Rates” 


on page 47 lists the streaming speeds for various network 


connection speeds. 


Targeting 28.8 Kbps Modems 


The following table lists possible RealAudio and Flash bit-rate combinations 
for 28.8 Kbps modems, which have a maximum streaming speed of 20 Kbps. If 
you choose an 8 Kbps music codec for RealAudio, for example, you have 12 
Kbps of streaming bandwidth left for Flash. 


Bandwidth Divisions between RealAudio and Flash at 20 Kbps 


Soundtrack Type RealAudio Codec 


Flash Maximum Speed 


Voice 6.5 Kbps Voice 


5 Kbps Voice 15 Kbps 
13.5 Kbps 
8.5 Kbps Voice 11.5 Kbps 


(Table Page 1 of 2) 
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Bandwidth Divisions between RealAudio and Flash at 20 Kbps (continued) 


Soundtrack Type RealAudio Codec Flash Maximum Speed 
Music 8 Kbps Music 12 Kbps 
11 Kbps Music 9 Kbps 


(Table Page 2 of 2) 


Targeting 56 Kbps Modems 


Suppose you want to reach 56 Kbps modems, which have a maximum 
streaming speed of 34 Kbps. The following table lists some RealAudio codecs 
you can use, indicating for each codec the streaming speed left for the Flash 


clip. 
Bandwidth Divisions between RealAudio and Flash at 34 Kbps 
Soundtrack Type RealAudio Codec Flash Maximum Speed 
6.5 Kbps Voice 27.5 Kbps 
Voice 8.5 Kbps Voice 25.5 Kbps 
16 Kbps Voice 18 Kbps 
11 Kbps Music 23 Kbps 
Music 16 Kbps Music 18 Kbps 
20 Kbps Music 14 Kbps 


Targeting Both 28.8 and 56 Kbps Modems 


To target both 28.8 and 56 Kbps modems, decide first how to reach the 28.8 
Kbps audience. For a voice soundtrack, for example, you might use a 6.5 Kbps 
RealAudio voice codec, leaving 13.5 Kbps for Flash. To reach 56 Kbps modems, 
you would encode the soundtrack as a SureStream RealAudio clip using both 
the 6.5 Kbps voice codec and a 16 Kbps voice codec. Users with 56 Kbps 
modems then get 16 Kbps of RealAudio data along with the 13.5 Kbps Flash 
clip. This puts the streaming speed for this combination at 29.5 Kbps, a little 
less than the 34 Kbps maximum. 


Tips for Choosing RealAudio Codecs 


Here are some tips for selecting a RealAudio codec to use with a streaming 
Flash clip: 
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- If sound quality takes precedence, use the fastest RealAudio codec that 
still leaves enough bandwidth for acceptable animation. 


+ When animation is complex, use low-speed RealAudio codecs targeted for 
voice. This increases the bandwidth available for the animation. 


+ If possible, do not select the lowest-speed RealAudio codec. SureStream 
clips include a duress stream that is used if the connection bandwidth 
falls. An 8 Kbps music clip, for example, includes a 6 Kbps duress stream. 
If you encode the clip using just the 6 Kbps codec, RealOne Player will 
have no duress stream to fall back on. 


+ To encode a RealAudio clip with exactly the codec you want, you may need 
to change the RealAudio default target audience settings. You need Helix 
Producer Plus to do this, because Helix Producer Basic does not allow 
changes to the default settings. 


Using Interactive Flash Commands 


Because RealOne Player supports all Flash 3 and Flash 4 commands, you can 
make your presentations interactive by adding buttons and forms. In some 
cases, Flash commands work differently in RealOne Player than in the Flash 
browser plug-in. This section provides guidelines for using Flash commands 
with RealOne Player presentations. 


Flash Clip Timeline Commands 


Flash has several commands you can use to control the Flash clip’s timeline. 
In a Flash 3 or 4 clip, these commands affect only the Flash clip. The 
presentation and all other clips playing along with the Flash clip continue 
through their timelines normally. In a Flash 2 clip, these commands affect all 
clips playing in RealOne Player. 


Interactive Flash Commands 
Command Function 


Play Begins or resumes Flash clip playback. 


Stop Pauses Flash clip until a Play command is issued. With a Flash 3 or 4 
clip, all other clips play normally. With a Flash 2 clip, all other clips 
pause. 


(Table Page 1 of 2) 
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Command 


Go To and 
Stop 


Interactive Flash Commands (continued) 
Function 


Seeks to the designated frame in the Flash clip and pauses. The Flash 
clip timeline resumes on a Play command. With a Flash 3 or 4 clip, all 
other clips play normally. With a Flash 2 clip, all other clips seek to the 
same point in the presentation timeline and then pause. See also “Go To 
Commands” on page 101. 


Go To and 
Play 


Get URL 


Seeks to the designated frame in the Flash clip, buffers the clip preroll, 
and begins playback. With a Flash 3 or 4 clip, all other clips play 
normally. With a Flash 2 clip, all other clips seek to the same point in 
the presentation timeline and then resume playback. 


Sends the URL to the RealOne Player media browser pane or, for earlier 


RealPlayers, the viewer’s default Web browser. If the user has to return 
to the animation manually, you may want to use this only at the end of 
a clip. Also note that a SMIL file can define clickable hyperlinks that 
overlay a Flash clip. See Chapter 15 for more information. 

(Table Page 2 of 2) 


RealOne Player Commands 


As noted in the preceding table, commands such as Play, Stop, and Go To in 
Flash 3 and Flash 4 clips affect only the Flash clip. Using Flash’s Get URL 
command, though, you can play, stop, or pause all clips playing in RealOne 
Player. You can also launch a URL in a new RealOne Player window. You do 
this by sending RealOne Player a command (rather than a URL) through Get 


URL. 


Seeking Into a Presentation 


The following value for Get URL instructs RealOne Player to seek to the 


specified time in the presentation timeline: 


command:seek(time) 


For example, the following command instructs RealOne Player to seek to 


1:35.4 in the presentation timeline: 


command:seek(1:35.4) 


The time format is as follows: 


dd:hh:mmi:ss.xyz 


Here, dd is days, hh is hours, mm is minutes, ss is seconds, x is tenths of 
seconds, y is hundredths of seconds, and z is milliseconds. Only the ss field is 


required. When the time value does not include a decimal point, RealOne 
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Player reads the last field as the seconds. For example, 1:30 means 1 minute 
and 30 seconds, whereas 1:30:00 means 1 hour and 30 minutes. Note that all 
of the following commands are equivalent. Each seeks to the point 90 minutes 
into the presentation timeline: 

command:seek(1:30:00.0) 

command:seek(90:00) 

command:seek(5400) 


Playing, Pausing, or Stopping a Presentation 


The following values for Get URL cause RealOne Player to play, pause, or stop 
the presentation, respectively: 
command:play() 


command:pause() 
command:stop() 


Popping Up New Media Windows 


Using the Get URL command, you can open streaming presentations in new 
RealOne Player media playback windows. You can open as many player 
windows as the computer’s CPU and memory allow. For information on 
opening a new media playback window, see “Opening a Media Playback 
Window with a Clip Link” on page 383. 


Go To Commands 


Use Go To commands only when adding interactivity to a Flash clip. Do not 
use them to advance from one scene to the next. When you export your 
animation in the Flash Player format, scenes are concatenated so that the 
animation flows from one scene to the next. A Go To command causes 
RealOne Player to seek to the target frame. If Helix Universal Server has not 
yet streamed the target frame, RealOne Player halts clip playback, issues a seek 
request to Helix Universal Server, and rebuffers the new data as it comes in. 


When you use at least one Go To command in a Flash 3 or 4 clip, RealOne 
Player caches the entire clip in memory. It assumes that the clip is interactive 
and that the Go To commands are meant to move the viewer from one part of 
the clip to another based on input such as a button click. After Helix Universal 
Server has streamed the frames containing the Go To command and its target, 
RealOne Player does not need to rebuffer the clip when the viewer gives the 
command. 
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Using a Go To command raises RealOne Player’s memory requirement for 
playing the clip. This is generally not a problem, because Flash memory 
requirements are low. When authoring long, linear animations, though, avoid 
using Go To commands whenever possible. When no Go To commands are 
present, RealOne Player discards clip data it no longer needs. This helps 
guarantee good-quality playback on computers that are low on available 
memory. 


Load Movie Commands 


RealOne Player imposes a restriction on using Flash’s Load Movie command to 
import a second Flash clip into a clip that is playing. If the clips use the RTSP 
protocol, Helix Universal Server stops the first clip and streams the second 
clip as a new RealOne Player presentation rather than streaming the second 
clip as part of the initial presentation. The Load Movie command works 
properly only when clips are downloaded with HTTP. There are two ways to 
manage this: 


+ Stream the first clip with RTSP by using rtsp:// in the SMIL or Ram file 
URL for the clip. In a Load Movie command, use a fully qualified HTTP 
URL for the clip. RealOne Player will then request the clip with the given 
URL. This is the preferred solution because the first clip uses RTSP, which 
is a better protocol for streaming. 


Tip: Helix Universal Server supports both RTSP and HTTP. 
You can therefore put all clips in the same Helix Universal 
Server directory, streaming the first one with RTSP and all of 
the others with HTTP. Just be sure not to include /ramgen/ in 
the URLs used with the Load Movie command. 


- The second solution is to download all clips by using HTTP. Use http:// in 
the SMIL or Ram file URL to the initial clip. In a Load Movie command, 
you can then refer to an imported clip using just its file name. RealOne 
Player requests subsequent clips using the same HTTP URL (except for the 
different file names) used to download the first clip. 


Tip: If your presentation does not use SMIL, use a Ram file 
instead of Ramgen to list the HTTP URL to the first clip. Helix 
Universal Server’s Ramgen utility adds /ramgen/ to the first 
clip’s URL. When RealOne Player reuses this URL, the /ramgen/ 
component starts a new presentation. 
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Timeline Slider Activity with Multiple Clips 


If your presentation includes multiple Flash clips integrated with Load Movie 
commands, the RealOne Player slider reflects only the first clip’s timeline. 
Suppose that a clip plays for five minutes and then loads another clip. The 
RealOne Player slider is active only for the five minutes the first clip plays. 
After that, the second clip plays normally, but RealOne Player indicates that 
the presentation has finished by resetting the timeline slider and disabling the 
stop button. Viewers can still perform interactive functions and stop the 
second clip by using Flash’s contextual menu, though. 


Using SMIL Instead of Load Movie 


You need to use the Load Movie command to insert a new Flash clip into a 
Flash clip that is already playing. You do not need to use this command to 
play two or more Flash clips in sequence, though. Instead, you can use SMIL 
to define the sequence. This overcomes the URL and timeline limitations 
described above. To play two clips in sequence, for example, you write a SMIL 


file that looks like the following: 


<smil xmlns=“http://www.w3.org/2001/SMIL20/Language”> 
<body> 
<seq> 
<animation src="rtsp://helixserver.example.com:554/media/cartoon1.swf" /> 
<animation src="rtsp://helixserver.example.com:554/media/cartoon2.swf" /> 
</seq> 
</body> 
</smil> 


You can also use SMIL to combine each Flash clip with a RealAudio clip. The 
example below has two clip groups that play in sequence. Each clip group is 
composed of a Flash clip and a RealAudio clip played in parallel: 


<smil xmlns=“http://www.w3.org/2001/SMIL20/Language”> 
<body> 
<seq> 
<par> 
<animation src="rtsp://helixserver.example.com:554/media/cartoon1.swf"/> 
<audio src="rtsp://helixserver.example.com:554/media/sound1.rm”/> 
</par> 
<par> 
<animation src="rtsp://helixserver.example.com:554/media/cartoon2.swf" /> 
<audio src="rtsp://helixserver.example.com:554/media/sound2.rm”/> 
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</par> 
</seq> 
</body> 
</smil> 


For More Information: For information on SMIL, see Chapter 8. 


Secure Transactions 


Using Flash forms, you can build transaction functionality directly into Flash 
clips streamed to RealOne Player. This lets you add e-commerce capability to 
your presentation, for example. If the Flash clip connects to a secure server, 
RealOne Player transmits the encrypted information through its built-in 
browser. Any encrypted response sent back by the secure server displays in the 
media browser pane, rather than the media playback pane in which the Flash 


clip plays. 


Tip: Because RealOne Player does not display responses to 
secure transmissions in its media playback pane, do not send 
an HTTP POST or GET command to a secure server if you 
intend for the server’s response to come back to the Flash clip. 
For example, do not connect to a secure server by using Flash’s 
Load Variables or Load Movie command. 


Note: Earlier versions of RealPlayer, which do not have built-in 
browsers, send secure transactions through the viewer’s default 
browser. 


Mouse Events 


When Flash animation plays in the RealOne Player media playback pane, 
RealOne Player tracks certain mouse events differently than does the Flash 
plug-in used with browsers. Although this does not change how you build a 
streaming Flash presentation and it will not affect most viewers, you should be 
aware of this behavior. 


The Flash browser plug-in records mouse events that occur outside of the 
Flash area. For example, a user may click and hold on an icon, drag the pointer 
out of the Flash area, and release the mouse button. In this case, the Flash 
browser plug-in knows that the mouse button has been released. The RealOne 
Player media playback pane, however, does not record mouse events that occur 
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outside of its Flash region. Instead, it assumes that the button is still held 
down when the pointer returns to the Flash region. 


Streaming a Flash Clip 


This section summarizes the process for streaming a Flash clip. The Flash 5 
program can export a RealAudio clip, a tuned Flash Player clip, and a SMIL 
file automatically. If you use Flash 5, refer to your Flash user’s guide for 
instructions on exporting and tuning clips. Macromedia’s Web site also 
provides information about exporting clips with Flash 5S: 


http://www.macromedia.com/support/flash/publishexport/realplayer/ 
realplayer.html 


If you are using a version of the Flash program prior to version 5, you must 
perform the following export and tuning steps manually. 


> To create a streaming Flash clip manually: 


1. Export the Flash Player clip. 


Helix Universal Server streams only the Flash Player format (.swf), which is 
a compressed version of the animation. You cannot stream the Flash 
source file format (.fla). If your animation includes a soundtrack, disable 
the audio stream when you export the clip. Refer to the Flash user manual 
for step-by-step instructions on the exporting a Flash Player clip. 


Note: Keep in mind that RealOne Player plays the Flash 4, 3, 
and 2 Player formats. It does not play clips in the Flash 5 
format. 


2. Tune the Flash Player clip. 


With the Flash tuner, set the clip's streaming bit rate. This necessary step 
also eliminates bandwidth spikes that can cause rebuffering. The tuner is 
included in the utilities folder of the zipped HTML version of this manual. 


For More Information: See “How to Download This Guide to 
Your Computer” on page 12 for instructions on getting a local 


copy of this guide. 


3. Export the soundtrack. 


If your animation includes a soundtrack, export the soundtrack as a 
Windows WAV file or Macintosh QuickTime file. If exporting to 
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QuickTime (or any other video format), set low height and width 
attributes to minimize disk space use. 

4. Encode the soundtrack as RealAudio. 
Encode the exported WAV or QuickTime soundtrack in the RealAudio 
format with Helix Producer, using the file extension .rm. 

5. Deliver the Flash presentation. 


Transfer your clips to Helix Universal Server. Then write the SMIL and 
Ram files necessary to stream the presentation. 


+ Streaming a single Flash clip 


If your have a single Flash clip, your Helix Universal Server 
administrator can give you the URL to use in your Web page’s 
hyperlink to the clip. If the Helix Universal Server does not use 
Ramgen, or you are delivering the clip through a Web server, you need 
to write a Ram file. 


For More Information: For more on Helix Universal Server and 
Ramgen, see “Using Ramgen for Clips on Helix Universal 
Server” on page 519. Ram files are described in “Launching 
RealOne Player with a Ram File” on page 507. 


Streaming a Flash clip with another clip 


If your presentation has multiple clips, you write a SMIL file that 
organizes the presentation and gives the clip URLs. You next link your 
Web page to the SMIL file. In its simplest form, the SMIL file gives the 
full URLs to the clips and specifies that the clips play in parallel. The 
following example is for a Flash clip that plays in parallel with a 
RealAudio soundtrack: 


<smil xmlns=“http://www.w3.org/2001/SMIL20/Language”> 
<body> 
<par> 
<audio src="rtsp://helixserver.example.com:554/media/sound.rm” /> 
<animation src="rtsp://helixserver.example.com:554/media/cartoon.swf"/> 
</par> 
</body> 
</smil> 
You can also use SMIL to define hypertext links, create timing offsets 
between clips, or add presentation information such as title, author, 
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copyright, and abstract. For complete information on SMIL, see 
Chapter 8. 
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WRITING MARKUP 


The RealNetworks markup languages let you create clips in 
addition to audio, video, and animation. With RealText, which 
Chapter 6 covers, you can create timed text that displays 
alongside other clips. Chapter 7 explains the RealPix markup for 
streaming slideshows from still images. 


CHAPTER 


6 


REALTEXT MARKUP 


With RealText, you can create timed text presentations that can 
stream alone or in combination with other media such as audio or 
video. This makes RealText a handy means for adding text to SMIL 
presentations. Using RealText, you can add subtitles to a video, for 
example, or provide closed-captioning. This chapter explains the 
RealText markup. Appendix E beginning on page 581 provides a 


reference for RealText tags and attributes. 


Understanding RealText 


Using any text editor, you can create a RealText clip in a text file that uses the 
file extension .rt. The file includes the text you want to display, as well as the 
RealText markup that describes how to display and time the text. Like a 
RealVideo or Flash clip, a RealText clip has a height and width, as well as an 
intrinsic duration, from a few seconds to several hours. The following are 
some of the features that RealText provides: 


« Font, size, and color control 


The RealText markup lets you create text in many different fonts, sizes, 
and colors. 


- Timing control 


RealText timing commands control when each paragraph, sentence, word, 
or letter appears. You might display a new sentence every few seconds, as 
in a video subtitle. Or you could make letters appear one at a time as if 
they were being typed across the screen. 


+» Flowing text 


Within a RealText clip, words can scroll up the screen or from side to side. 
This lets you create a window of smoothly flowing text. You can even 
make text loop, creating an endlessly flowing marquee. 
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+ Positioning commands 


With the optional positioning commands, you can control exactly where 
each word appears within the RealText window. 


RealText Language Support 


RealText supports a number of languages, including English, Chinese, 
Korean, Japanese (Kanji), and many European languages. It can stream text in 
any language that can be written in one of its supported character sets, which 
are listed in the section “Specifying the Character Set” on page 128. Each 
character set supports at least one font, as described in “Setting the Font” on 
page 130. 


Note: Character set and font support is built into RealText. 
Therefore, RealText does not necessarily support all character 
sets and fonts supported by various Web browsers. 


Structure of a RealText Clip 


A RealText clip is a text file that uses the file extension .rt. At the top of the file 
you write a <window> tag that can include several attributes that set overall 
parameters, such as the window type, width, height, and duration. The file 
ends with a </window> tag. Between these tags, you add the text that you want 
to display in RealOne Player, using RealText tags and attributes to lay out and 
time the text. The following example is a simple RealText file that displays a 
new line of text every three seconds: 

<window height="250" width="300” duration="15”" bgcolor="yellow”> 

Mary had a little lamb, 

<br/><time begin="3”/>little lamb, 

<br/><time begin="6"/>little lamb, 

<br/><time begin="9"/>Mary had a little lamb 

<br/><time begin="12"/>whose fleece was white as snow. 

</window> 


Rules for RealText Markup 


The RealText markup is similar to SMIL, and follows the same basic rules 
described in “Creating a SMIL File” on page 197. The following are the main 
points in mind when writing a RealText file: 


- Use lowercase characters for RealText tags and attributes. 
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- A tag that does not have a corresponding end tag (for example, the <ul> 
tag has the end tag </ul>), closes with a forward slash, as in a <br/> tag, for 
example. 


- Attribute values must be enclosed in double quotation marks. 


+ Save your RealText file with the file extension .rt. Do not include spaces in 
the file name. For example, you can have the file my_realtext.rt but not the 
file my realtext.rt. 


- Use codes to include angle brackets, ampersands, or nonbreaking spaces 
as RealText display characters. See “Using Coded Characters” on page 140. 


- As in HTML, you can add a comment to a RealText file like the following. 
Note that the comment tag does not need to close with a slash. 


<!-- This is a comment --> 


RealText Bandwidth 


Because a RealText clip is a simple text file, it consumes minimal bandwidth 
and streams quickly to RealOne Player. RealText presentations are therefore 
easily accessible to viewers with slow network connections. When combining 
RealText with other clips, you need to ensure that RealText has approximately 
1 Kbps of available bandwidth. 


Tip: If you have a large RealText file, you can compress it with 
GZIP when delivering the clip from many Web servers. For 
more information, see “GZIP Encoding for Large Text Files” on 
page 523. 


For More Information: For more on bandwidth allocation, see 
“Step 4: Develop a Bandwidth Strategy” on page 45. 


RealText ina SMIL Presentation 


You can easily combine RealText with any other clip through a SMIL file. 
Chapter 8 explains the basics of SMIL. The section “Playing Clips in Parallel” 
on page 249 explains how to display RealText along with other clips. You'll 
also need to understand SMIL layouts as described in Chapter 12. The section 
“RealText Window Size and SMIL Region Size” on page 117 explains various 
ways to coordinate the RealText window size to its SMIL region size. 
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Tip: To see examples of RealText displayed with other clips, get 
the zipped HTML version of this guide as described in “How to 
Download This Guide to Your Computer” on page 12, and 
view the Sample Files page. 


RealText Broadcast Application 


RealText does not have to be created in a static file. A broadcast application 
can capture live text, add RealText markup to it, and send it to Helix Universal 
Server. A sample broadcast application is included with the Software 
Development Kit (SDK), available for download at this Web page: 


http://proforma.real.com/rnforms/resources/server/realsystemsdk/ 
index.html 


Setting RealText Window Attributes 


The <window> and </window> tags that begin and end a RealText file, 
respectively, set presentation attributes such as the window’s height and width 
Here is an example of a <window> tag: 

<window type="marquee” duration="2:05:00.0” underline_hyperlinks="false”> 


...all text and RealText markup... 
</window> 


You specify attributes in the form attribute=“value” within the <window> tag, 
much as you specify HTML table attributes within the HTML <TABLE> tag. No 
attributes are required for the <window> tag, however. If you do not specify an 
attribute, the attribute's default value applies. The following table 
summarizes the <window> tag attributes. 


RealText <window> Tag Attributes 


Attribute Value Function Reference 
bgcolor name|#RRGGBB| Sets the window color. page 116 
transparent 
crawlrate pixels_per _second Sets the horizontal text speed. page 121 
duration hh:mmi:ss.xy Specifies presentation length. page 118 
extraspaces | use|ignore Recognizes or ignores extra page 122 
spaces in text. 
height pixel Sets the window pixel height. page 116 


(Table Page 1 of 2) 
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RealText <window> Tag Attributes 


Attribute Value Function Reference 
link name |#RRGGBB Specifies the hyperlink color. page 121 
loop false|true Turns text looping on or off. page 122 
scrollrate | pixels_per _second Sets the vertical text speed. page 121 
type generic|tickertape| Sets the window type. page 115 
marquee|scrollingnews| 
teleprompter 
underline | false|true Determines whether hyperlinks | page 121 
_hyperlinks are underlined. 
version 1.0|1.2]1.4]1.5 Specifies RealText version. page 120 
Required for some character sets. 
width pixels Sets the window pixel width. page 116 
wordwrap _| false|true Turns word wrap on or off. page 121 


Specifying the Window Type 


(Table Page 2 of 2) 


The <window> tag’s type=“window type” attribute sets specific properties for the 


RealText clip: 


<window type="Sscrollingnews” ...> 


Choose a window type depending on how you want to display text. Each 
window type has preset default values that make it easier to create certain 
types of text displays. You can create any type of RealText clip using just the 
default window type of generic, however. The following are the RealText 


window types: 


* generic 


This is the default window type. You can use the generic window type to 


create any type of RealText clip based on the other attributes you include 


in the <window> tag. 


* scrollingnews 


A scrollingnews window scrolls text upward at a specified rate for the 


entire presentation. The text initially appears at the top of the window. 


¢ teleprompter 


A teleprompter window fills the display area with text starting at the top 


of the screen. As more timed text displays, the new text appears at the 
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bottom of the screen and pushes older text up. The text does not scroll 


smoothly as in a scrollingnews window, though. 


* marquee 


In a marquee window, text crawls from right to left and can loop. Text is 


centered vertically within the window. 


* tickertape 


A tickertape windiw is like a marquee window, but text displays at the 
window's top or bottom edge, rather than in the center. 


Window Type Default Values 


Each window type sets a number of default values for the RealText clip. The 
following table lists the attribute default values that differ based on the choice 
of window type. Keep in mind that you can change any default value for any 
window type through the <window> tag. If you want a marquee window to be 
320 pixels wide instead of 500 pixels, for example, you add width="320" to the 
<window> tag to override the window type’s default width value. 


Default Values for RealText Window Types 


Value generic scrollingnews teleprompter marquee tickertape 
width in pixels (page 116) | 320 320 320 500 500 
height in pixels (page 116) | 180 180 180 30 30 
background (page 116) white | white white white | black 
horizontal crawl rate in 0 0 0 20 20 
pixels per second (page 

121) 

vertical scroll rate in 0 10 0 0 0 
pixels per second (page 

121) 

text looping (page 122) no no no yes yes 


Setting the Window Size and Color 


The width and height attributes determine the RealText window’s width and 
height in pixels, respectively. The bgcolor attribute determines the window's 
background color. “Specifying RealText Color Values” on page 134 explains 
RealText color values. Here is an example that sets a window size and color: 


<window width="400” height="225” bgcolor="blue”...> 
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For More Information: Default values for size and background 
color are listed in the table “Default Values for RealText 
Window Types” on page 116. 


Creating a Transparent Window Background 


Using the rn:backgroundOpacity attribute in SMIL, you can turn the RealText 
window’s background color fully transparent or semi-transparent, which is 
useful when overlaying a video with RealText subtitles. Within the RealText 
file, you define an opaque color, such as black or white, as the value of the 
<window> tag’s bgcolor attribute. In your SMIL file, you then specify a 
percentage value for rn:backgroundOpacity. 


For More Information: For more information about 
rn:backgroundOpacity, see “Creating Transparency in a Clip’s 
Background Color” on page 223. For an example of using 
SMIL to display different RealText subtitles based on viewer 
language preferences, see “Subtitles and HTML Pages in 
Different Languages” on page 458. 


RealText Window Size and SMIL Region Size 


When you add RealText to a SMIL presentation, you display your RealText clip 
in a SMIL region. For best results, create a SMIL region that is the same height 
and width as the RealText clip. Displaying a RealText clip in a SMIL region 
that is larger or smaller than the clip may enlarge or shrink the text, 
depending on how you set the <region> tag’s fit attribute. The sections below 
explain which fit values are best to use. 


Note that enlarging or shrinking a RealText clip through SMIL does not affect 
line breaks. Line breaks are determined by the RealText window’s width, font, 
and font size. You could place a RealText window that is 200 pixels wide in a 
SMIL region that is 150 pixels wide, for example, and scale the clip’s width 
down by adding fit= “fill” to the SMIL <region> tag. This simply makes all the 
text smaller. It does not cause lines to break at different places within the text. 


For More Information: SMIL regions are described in “Playback 
Regions” on page 268. The section “Fitting Clips to Regions” 

on page 301 explains the <region> tag’s fit attribute. RealText 

word wrapping is described in “Wrapping Text to New Lines” 
on page 121. 
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When a SMIL Region is Larger than the RealText Clip 

When the SMIL region is larger than the RealText clip, the default value 
fit=“hidden” is recommended for the <region> tag. This keeps the RealText clip 
as its specified size. You can then use a registration point, as described in 
“Positioning Clips in Regions” on page 295, to position the clip within the 
region. The registration point might center the clip in the region, for example. 
If you want to scale the RealText clip larger, using fit=“meet” in the <region> tag 
typically gives the best results because it preserves the clip’s aspect ratio. This 
scales the text larger but maintains the relative letter spacing. You can use 
fit="fill” to make the RealText clip the same size as the region, but distortion 
in letter spacing may make the clip unreadable if the region has a markedly 
different width-to-height ratio than the clip. 


When a SMIL Region is Smaller than the RealText Clip 

When the SMIL region is smaller than the RealText clip, the default value 
fit=“hidden” in the <region> tag may prevent some text from displaying. The 
value fit=“meet” is generally the best choice, because it scales the clip smaller to 
fit completely inside the region while preserving the relative letter spacing. 
When displaying RealText in a smaller region, though, you need to be careful 
to keep the text from scaling down to an unreadable size. 


Setting the Clip Duration 


The duration attribute specifies how long the RealText clip plays. The default is 
60 seconds. RealText uses only the “normal play time” timing values of 
hh:mm:ss.xy, which are described in “Using the Normal Play Time Format” on 
page 314. In this timing method, only the ss field is required. For example, the 
following duration attributes make the clip last 90 seconds: 


<window duration="90" ...> 

5 and 1/2 minutes: 

<window duration="5:30" ...> 

and 1 hour, 33 minutes, and 15 seconds: 


<window duration="1:33:15” ...> 


RealText Durations and SMIL Durations 


When you put RealText in a SMIL presentation, SMIL timing values can 
override the duration defined in the RealText clip. Suppose a RealText clip 
named marquee.rt has a duration of three minutes: 
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<window duration="3:00.0” ...> 


If you put this clip into a SMIL presentation with the following SMIL clip 
source tag, the dur="2min” attribute tells RealOne Player to stop playing this 
clip after two minutes regardless of the clip’s internal timeline: 


<textstream src="rtsp://helixserver.example.com/marquee.rt dur="2min” .../> 


If the SMIL duration is longer than the RealText duration, a fill attribute can 
specify how RealOne Player treats the clip once it has stopped playing: 


<textstream src="rtsp://helixserver.example.com/marquee.rt dur="4min” 
fill="freeze” /> 


For More Information: For more on the SMIL fill attribute, see 
“Setting a Fill” on page 327. 


Tips for Setting RealText Clip Durations 


+ When you work with both SMIL and RealText, be careful not to confuse 
the different duration attributes. In RealText, the duration attribute must 
be duration, whereas in SMIL it must be dur. 


+ RealText uses only the normal play time format (hh:mmiss.xy) for setting 
time values. It cannot use SMIL timing shorthand values such as “3min”. 


- If your RealText clip stops before all text has displayed, the duration time 
is probably set too low. To help prevent this problem, set a high duration 
when you start writing your RealText markup. Then set the final duration 
time when you have finished defining the RealText markup. 


+ The final duration should be slightly higher than the time it takes to 
display all the text. If all text displays within two minutes, for example, set 
a duration of two minutes and five seconds. 


+ Setting a duration much higher than the time it takes all text to display 
may unnecessarily delay clips that play after the RealText clip in a SMIL 
sequence, and can make it difficult for viewers to use the RealOne Player 
position slider to search for specific parts of the RealText clip. 


- The duration time you set is reflected in RealOne Player. If you set a 
duration of five minutes, for instance, the RealOne Player status bar lists 
the clip length as 5:00.0 and the RealOne Player position slider takes five 
minutes to travel from left to right. 


+ Text is not erased at the end of a RealText clip’s duration. The final text 
remains in the RealText window unless you erase the text with a <clear/> 
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tag, or the text moves out of the window because you have set a scrollrate 
or a crawlrate. 


For More Information: See “Clearing Text from the Window” on 
page 125 and “Setting a Scroll Rate or a Crawl Rate” on page 
121. 


Adding a Version Number 


The <window> tag can include a version number, as shown in this example: 


<window version="1.5"...> 


You typically do not have to specify a version number when using RealText in 
English. Properly displaying languages other than English may require that 
you specify a version number explicitly in the <window> tag, however. This 
chapter tells you when a version number is required to use a specific feature. 
The following paragraphs summarize the features that require you to add 
version numbers: 


* version="1.2” 
This RealText version provides support for the mac-roman character set, 
and changes the default character set from us-ascii to iso-8859-1. This 
version requires RealPlayer 7 or later, so RealPlayer G2 will autoupdate to 
the latest version of RealOne Player before playing the clip. 


version="1.4” 


This RealText version provides support for the iso-2022-kr character set 
and the Korean language. This version requires RealPlayer 7 or later, so 
RealPlayer G2 will autoupdate to the latest version of RealOne Player 
before playing the clip. 


version="1.5” 

This RealText version supports hyperlinks in the format protocol:path, as 
explained in “Issuing RealOne Player Commands” on page 140. This 
version requires RealPlayer 8 or later, so RealPlayer G2 and RealPlayer 7 
will autoupdate to the latest version of RealOne Player before playing the 
clip. 


Tip: Because newer versions of RealText encompass all features 
from previous versions, you can always specify a higher version 
than that required for a feature. If a feature requires RealText 

version 1.2, for example, you can use 1.5 as the version number. 
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Specifying Hyperlink Appearance 
The underline_hyperlinks="false|true” attribute determines whether hyperlinks 
are underlined. The default is true. The link=“color” attribute, which defaults to 
blue, sets the color of hyperlinks within the text. Here is an example: 


<window underline_hyperlinks=“false” link="red” ...> 


For More Information: See “Specifying RealText Color Values” 
on page 134 for color options. 


Controlling Text Flow 


As described in the following sections, several <window> tag attributes 
(scrollrate, crawlrate, wordwrap, loop, and extraspaces) affect how text displays in 
the RealText clip. 


Setting a Scroll Rate or a Crawl Rate 


The scrollrate attribute sets the number of pixels per second that the text 
scrolls from the bottom of the window to the top for the duration of the clip. 
It has no effect on tickertape and marquee windows. Here is an example: 


<window scrollrate="25” ...> 


The crawlrate attribute specifies the number of pixels per second that the text 
moves horizontally from right to left for the duration of the clip. Here is an 
example: 


<window crawlrate="40” ...> 


Tip: A RealText clip should not use both scrollrate and 
crawlrate. For best results, use a scrollrate or a crawlrate under 
30. The best values are 25, 20, 10, 8, 5, 4, 2, and 1. For rates faster 
than 30, use multiples of 20 or 25, such as 40, 50, 60, 75, 80, and 
so on. 


For More Information: The table “Default Values for RealText 
Window Types” on page 116 lists the default values for 
scrollrate and crawlrate in the standard window types. 


Wrapping Text to New Lines 


The wordwrap="false|true” attribute, which defaults to true, specifies whether 
word wrap is performed. When word wrap is on, text lines longer than the 
specified window width wrap to the following line. If it is off, long lines are 
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truncated by the window border. This attribute has no effect for windows that 
have horizontal text motion, such as a marquee window. 


Looping Text 


The loop="false|true” attribute is available only in tickertape and marquee 
windows, which have horizontal “crawling” motion. In these window types, 
the loop attribute defaults to true, which tells RealOne Player to redisplay 
(“loop”) text under these circumstances: 


- In aclip that does not use <time begin="...”> tags to set begin times on text 
blocks, looping occurs if all text has moved out of the window but the 
clip’s duration has not expired. If the duration is two minutes but all text 
has moved out the window after one minute, for example, the text begins 
again. 


- In aclip that uses <time begin="...”> tags to set begin times, text blocks 
loop if they have scrolled out of the window and the next text block’s 
begin time has not elapsed. For example, consider this markup: 


...first text block...<time begin="1:00.0"><clear/><br/>...second text block... 


In this case, the first text block loops as necessary for one minute. At that 
time, the <clear/> tag erases the window and the <br/> tag starts the 
second text block at the window’s right-hand side. 


For More Information: For information on timing and erasing 
text, see “Timing and Positioning Text” on page 123. The <br/> 
tag is described in “Adding Space Between Text Blocks” on 
page 135. 


- In a RealText broadcast, text loops as necessary until new text arrives. If 
the text is looping as the new text arrives, the new text displays as soon as 
the old text has moved out of the window. The new text then becomes 
part of the loop. 


Ignoring Extra Spaces 


When set to its default value of use, the extraspaces=“use|ignore” attribute 
makes RealText recognize all blank spaces between text chunks and markup 
tags. If three spaces occur between two words in the RealText file, for example, 
RealOne Player displays all three spaces. It treats each carriage return and tab 
as a space. 
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If you specify extraspaces="ignore”, RealOne Player treats spaces, tabs, line 
feeds, and carriage returns as does a Web browser, except when they are 
between the <pre>...</pre> tags. When spaces or carriage returns occur 
contiguously in the text, RealOne Player interprets them as a single space, no 
matter how many of them are present. So in this case, three contiguous spaces 
display as one space in RealOne Player. 


For More Information: The <pre>...</pre> tags are described in 
the section “Preformatting Text” on page 136 


Timing and Positioning Text 


The following sections explain the RealText tags you can use between the 
<window> and </window> tags to control when and where text appears within 
the RealText window. The following table summarizes the RealText timing 
and positioning tags. 


RealText Time and Position Tags 


Tag Attributes Function Reference 
<clear/> (none) Clears all text. page 125 
<pos/> x=“pixels” |y="pixels” Positions text. page 126 
<required>... | (none) Ensures that text is delivered. | page 127 
</required> 

<time/> begin=“hh:mm:ss.xy”| | Sets time when text appears or | page 123 

end=“hh:mm:ss.xy” disappears. 

<tl>...</tl> color="name|#RRGGBB” | Puts text at bottom of ticker. | page 126 
<tu>...</tu> | color="name|#RRGGBB” | Places text at top of ticker. page 126 


Controlling When Text Appears and Disappears 


The <time/> tag controls the RealText presentation timeline by specifying 
when text blocks appear or disappear. The <time/> tag is useful primarily in 
RealText clips in which text does not scroll or crawl across the screen. In these 
clips, RealOne Player displays all text as quickly as it can if you do not time the 
text with <time/> tag. 


The <time/> tag can have two attributes, begin and end. You can use one or 
both attributes in each <time/> tag. Each attribute specifies a time when the 


123 


RealNetworks Production Guide 


124 


text appears or disappears, respectively. As with the <window> tag’s duration 
attribute, a <time/> tag specifies a time in the “normal play time” format: 


<time begin=“hh:mmiss.xy"/> 
<time end=“hh:mmi:ss.xy"/> 


In the following sample text block, the first phrase appears at the start of the 
RealText presentation. The subsequent text blocks appear at three seconds 
into the timeline, and six seconds into the timeline, respectively: 


Mary had a little lamb, <time begin="3"/>little lamb, <time begin="6”/>little 
lamb. 


For More Information: See “Using the Normal Play Time 
Format” on page 314 for more on <begin> tag timing values. 


Using an End Time 


Text with an end time is erased when the specified end value is reached. 
Otherwise it stays active until the presentation ends or the entire window is 
erased with <clear/>. In the following example, text blocks begin at different 
times, but all end at the same time. Note that just as with a begin time, an end 
time must appear before the text block in the file: 

<time end="25"/><time begin="5"/>This text starts to display at 5 seconds. 

<time begin="10"/>A new line appears each additional 5 seconds. 

<time begin="15"/>But all this text disappears ... 

<time begin="20"/>at 25 seconds into the clip. 


You can also combine the begin and end attributes in a single <time/> tag as 
shown here: 


<time begin="23” end="55.5”"/>This text displays 23 seconds into the presentation 
and disappears at 55.5 seconds. 


It’s important to note that text following a <time/> tag has the specified begin 
or end value until a new value is given. Therefore, once you specify an end time 
for a text block, you must specify an end time for all following blocks. For 
example, the following text would not display properly: 


<time begin="23” end="55.5”"/>Display at 23 seconds in. 
<time begin="56"/>Display at 56 seconds in. 


Because the second line in the preceding example does not include an end 
time, the previous end time of 55.5 still applies. The second line cannot be 
displayed, however, because its begin time is later than its end time. 
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Tips for Using <time/> Tags 


- The <time/> tags are not necessary in a window with a scrollrate or 
crawlrate unless you want to delay text, have it become visible after it has 
moved into the window, or have it disappear before it moves out of the 
window. See also “Looping Text” on page 122 for information on how 
<time/> tags can affect text looping. 


To freeze text on the screen after the clip’s duration has elapsed, do not set 


an end time. Or, have the end time exceed the window’s duration as shown 
in this example: 


<window duration="30" ...> 

...some text elements... 

<time begin="25”" end="31"/>Text that stays frozen onscreen. 
</window> 


To replace a line of text with a new line every few seconds (as in video 
subtitles), do not use end times. For each new line of text, set the 
appropriate begin time followed by a <clear/> tag, as described below. 


Clearing Text from the Window 


The <clear/> tag removes all text from the window. The text that follows this 
tag then displays at the window's normal starting point, which is typically the 
window’s top or right edge, unless you position the text elsewhere. You can 
add <clear/> after <time begin="...”/> to erase text before displaying new text. 
This is often an easier method of removing text than using <time end="..."/> 
tags. In the following example, each new line erases the preceding line: 

<time begin="5"/>This line displays at 5 seconds. 

<time begin="10"/><clear/>This line erases the previous line at 10 seconds. 

<time begin="15"/><clear/>This line erases the previous line at 15 seconds. 

<time begin="20"/><clear/>This line erases the previous line at 20 seconds. 


A <clear/> tag removes all preceding text, even text that has an end time that 
has not yet elapsed. In the following example, the second line of text is set to 
end at 20 seconds. However, the <clear/> tag appears at 15 seconds into the 
presentation and clears this line, eliminating the end time for all following 
text: 

<time begin="5"/>They all lived happily. 

<time begin="10" time end="20"/>And so our story ends. 

<time begin="15"/><clear/>Goodbye! 
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Note: The <clear/> tag does not reset text appearance. For 
example, if text appears bolded before the <clear/> tag, it 
remains bolded after the <clear/> tag. 


Positioning Text ina Window 


These <pos/> tag can position text anywhere in the RealText window. You can 
use its x attribute for horizontal positioning, and its y attribute for vertical 
positioning. Each attribute takes a value in pixels, as shown in these examples: 
<pos x="10"/> 

<pos y="25"/> 


A <pos y="pixels”/> tag moves the upper, left corner of the subsequent text 
block the specified number of pixels down from the window’s top edge. A <pos 
x="pixels”/> tag indents the text block the specified number of pixels in 
addition to the two-pixel default padding that applies to all text blocks. You 
can combine both tags in a single tag like this: 


<pos x="10" y="25"/> 
Note: These tags work only if scrollrate and crawlrate are both 0 


(zero). For more on these attributes, see “Setting a Scroll Rate 
or a Crawl Rate” on page 121. 


Aligning Text in a Tickertape Window 


Th <tu>...</tu> and <tl>...</tl> tag sets function only with tickertape windows. 
They display the enclosed text at the window's upper (<tu>...</tu>) or lower 
(<tu>...</tu>) edge. Optionally, they can include a color attribute that specifies 
the color for the text, as shown in this example: 


<tu color=“blue”>...text to display at tickertape window’s upper edge...</tu> 
<tl color=“yellow”’>...text to display at tickertape window’s lower edge...</tl> 


When a tag specifies a color with the color attribute, the color applies to text 
enclosed by all subsequent tags of that type until another tag of that type 
changes the color. However, color specified for <tu> elements does not affect 
color for <tl> elements, and vice versa. The default color for <tu> elements is 
white, the default for <tl> elements is green. 


For More Information: Refer to “Specifying RealText Color 
Values” on page 134 for information about choosing colors. 
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Ensuring Text Delivery 


Use the <required> and </required> tags to enclose text that must be delivered 
to RealOne Player under any circumstance. During extremely adverse network 
conditions, Helix Universal Server will halt the presentation if necessary rather 
than drop the text. You can use these tags sparingly, though, because Helix 
Universal Server normally ensures that very little data loss occurs in 
transmission. 


Note: Although Helix Universal Server provides reliable 
streaming, packets not marked as required may be lost 
occasionally. If a block of text does not get through, RealOne 
Player displays a red ellipsis (...) to indicate missing text. 


Specifying Languages, Fonts, and Text Colors 


The RealText <font> tag controls the text font and color. Because it also 
specifies the character set, it determines which languages you can write in. As 
shown in the following example, the <font> tag can take multiple attributes, 
and it always uses an end tag: 


<font size="+2” face="Courier New” color="red”>...text...</font> 


Multiple <font> tags can also be nested to turn various font features on and 


off: 


<font attribute="A”>...turn on font attribute “A”... 
<font attribute="B">...turn on font attribute “B”... 
</font>...turn off font attribute “B”... 
</font >...turn off font attribute “A”... 


The following table summarizes the RealText <font> tag attributes. 


RealText <font> Tag Attributes 


Attribute Value Function Reference 

bgcolor name|#RRGGBB Sets a background color. | page 134 

charset us-ascii|iso-8859-1| Specifies character set page 128 
mac-roman|x-sjis| used to display text. 


gb2312|big5|iso-2022-kr 


color name|#RRGGBB Controls font color. page 134 
(Table Page 1 of 2) 
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RealText <font> Tag Attributes (continued) 


Attribute Value Function Reference 
face (see font tables) page 130 


size -2|-1|+0]+1|+2|+3|+4 Sets the font size. page 133 


or 
1[2|3|4|5|6|7 


(Table Page 2 of 2) 


Specifying the Character Set 


With the <font> tag’s charset attribute, you can control the character set used 
to display the text. You do not need to specify the character set explicitly to 
write text in English. However, you may need to specify the character set to 
write text in other supported languages. You can set the character set as well as 
the font face immediately after the <window> tag within a RealText file, as 
shown in the following example: 


<window version="1.4"...> 

<font charset="iso-2022-kr” face="Batang”> 

...Korean text that uses the iso-2022-kr character set and Batang font... 
</font> 

</window> 


You can also use multiple <font> tags to change character sets within a 
RealText file and display text in different languages: 

<font charset="iso-2022-kr” face="Batang”> 

...Korean text that uses the iso-2022-kr character set and Batang font... 
</font> 

<font charset="x-sjis” face="Osaka”> 

... Kanji text that uses the x-sjis character set and Osaka font... 

</font> 


It is important to note that RealText always uses its specified character set, not 
the default character set of the computer playing the clip. In RealText version 
1.2 and higher, the default character set is iso-8859-1. To display Korean text 
on a machine that uses the iso-2022-kr character set by default, for instance, 
you must explicitly set charset="iso-2022-kr” in the RealText <window> tag. If 
you do not, RealText will use its default iso-8859-1 character set, even though 
iso-2022-kr is the machine’s default. 


Note: If the computer does not recognize the character set 
specified in the RealText clip, it displays the text in its default 
character set. The result is typically unreadable. 
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For More Information: As noted in the following sections, using 
some character sets requires you to include a version number 
in the <window> tag. For more on version numbers, see “Adding 
a Version Number” on page 120. 


us-ascii 


The us-ascii character set is the default character set used with most RealText 
fonts when no version number is specified in the <window> tag. 


iso-8859-1 


The iso-8859-1 character set is identical to us-ascii, but includes support for 
accented characters (upper 128 characters) used in many European languages. 
This is the default character set used when you specify version="1.2” or higher 
in the <window> tag. Use it when writing accented European languages on a 
Windows or Unix computer. You can represent the following languages with 
the iso-8859-1 character set: 


Afrikaans Basque Catalan Danish Dutch English 
Faeroese Finnish French Galician German Icelandic 
Irish Italian Norwegian Portuguese Spanish Swedish 


Note: The ISO-8859 standard specifies several additional 
character sets, such as iso-8859-2 and iso-8859-3. RealText 
supports only iso-8859-1, however, meaning that Cyrillic, 
Arabic, Greek, Hebrew, and several Eastern European 
languages are not supported in RealText. 


mac-roman 


Use the mac-roman character set when writing in an accented European 
language on a Macintosh computer. Using this character set ensures that 
marks such as umlauts (for example, “ti”) display properly when the RealText 
clip plays on a Windows or Unix computer. Use version="1.2” or higher in the 
<window> tag to handle this character set correctly. 


Note: You do not need to use the mac-roman character set when 
writing in English. When writing in accented languages on a 
Windows or Unix machine, use the iso-8859-1 character set 
instead. 
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X-SJis 
The x-sjis character set is for Kanji and the Osaka font. Use version="1.2” or 
higher in the <window> tag to handle this character set correctly. 


gb2312 
The gb2312 character set is for Simplified Chinese. 


bigs 


The big5 character set is for Traditional Chinese. 


iso-2022-kr 


The iso-2022-kr character set is for Korean. Use version="1.4” or higher in the 
<window> tag to handle Korean text correctly. 


Setting the Font 


This <font> tag attribute face=“font name” controls the font use. You can use 
any number of fonts in the same RealText clip. When switching fonts, be sure 
to turn off the preceding font with a </font> tag, as shown in this example: 
<font face="Arial”> 

... Text in the Arial font... 

</font> 

<font face="Garamond”> 

... Text in the Garamond font... 

</font> 


Font faces correspond to character sets as described in the section “Specifying 
the Character Set” on page 128. For non-Western fonts, you must specify the 
correct character set for the font to display properly. If you specify no font, 
RealText uses the Times New Roman or Times font regardless of the character 
set specified. 


English and European Language Fonts 


When writing in English or European languages, use a font name from the 
“Windows Font Name” column of the following table, which lists fonts that 
use the us-ascii or iso-8859-1 character set. If the specified font isn’t available 
on a Macintosh or Unix computer, RealText uses a system font as indicated in 
the table below. For example, a RealOne Player on a Macintosh displays text in 
Courier if the Algerian font is not available. The notation “(always)” indicates 
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cases where RealText always defaults to a system font. For example, the 


Fixedsys font always displays as Courier on a Macintosh. 


RealText Font Support for us-ascii and iso-8859-1 Character Sets 


Windows Font Name 


Macintosh Default 
if Font not Available 


Unix Default 
if Font not Available 


Algerian Courier Courier 
Arial Helvetica Helvetica 
Arial Black Helvetica Helvetica 
Arial Narrow Helvetica Helvetica 
Arial Rounded Mt Bold Helvetica Helvetica 
Book Antiqua Helvetica Helvetica 
Bookman Old Style Helvetica Helvetica 
Braggadocio Helvetica Helvetica 
Britannic Bold Helvetica Helvetica 
Brush Script Times Times 
Century Gothic Helvetica Helvetica 
Century Schoolbook Helvetica Helvetica 
Colonna Mt Times Times 
Comic Sans Ms Times Times 
Courier New Courier Courier 
Desdemona Helvetica Helvetica 
Fixedsys Courier (always) Courier 
Footlight Mt Light Helvetica Helvetica 
Garamond Times Times 
Haettenschweiler Helvetica Helvetica 
Helvetica (Arial is used if | Helvetica Helvetica 
Helvetica is not found.) 

Impact Helvetica Helvetica 
Kino Mt Times Times 
Matura Mt Script Capitals | Times Times 
Modern Helvetica Helvetica 
Ms Dialog Times Times 
Ms Dialog Light Times Times 
Ms Linedraw Helvetica Helvetica 


(Table Page 1 of 2) 


131 


RealNetworks Production Guide 


RealText Font Support for us-ascii and iso-8859-1 Character Sets 
Macintosh Default Unix Default 


Windows Font Name if Font not Available — if Font not Available 
Ms Sans Serif Helvetica Helvetica 
Ms Serif Helvetica Helvetica 
Ms Systemex Times Times 
Playbill Times Times 
Small Fonts Times Times 
System Geneva (always) Times 
Terminal Geneva Times 
Times New Roman Times (always) Times 
Verdana Helvetica Helvetica 
Wide Latin Helvetica Helvetica 


(Table Page 2 of 2) 


Tip: A Macintosh that has Microsoft Internet Explorer 4.0 or 
later installed should have most of the Windows fonts. 


Asian Language Fonts 


RealText also supports the following fonts that use character sets other than 
us-ascii and iso-8859-1. 


RealText Font Support for Non-Western Character Sets 


Font Name Characters _RealText Font Face Tag charset 
AppleGothic Korean <font face=“AppleGothic”> iso-2022-kr 
Batang Korean <font face=“Batang”> iso-2022-kr 
BatangChe Korean <font face=“BatangChe”> iso-2022-kr 
Gothic Korean <font face=“Gothic”> iso-2022-kr 
Gulim Korean <font face="Gulim”> iso-2022-kr 
GulimChe Korean <font face="“GulimChe”> iso-2022-kr 
Osaka Kanji <font face=“Osaka”> x-sjis 
Seoul Korean <font face=“Seoul”> iso-2022-kr 


(Table Page 1 of 2) 
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RealText Font Support for Non-Western Character Sets (continued) 
Font Name Characters _RealText Font Face Tag charset 


rg: Simplified | <font face=""E11a”> gb2312 
a sin Chinese (The face name displays as gibberish 
without the gb2312 character set.) 


Traditional | <font face="20°GAé"> big5 
AH HA H tj C| Chinese (The face name displays as gibberish 


without the big5 character set.) 


(Table Page 2 of 2) 


Note: Korean and Japanese are supported in RealOne Player for 
Windows and Macintosh, but not for Unix. 


Setting the Text Size 
The <font> tag attribute size="n" lets you control the font size, as shown in this 
example: 
<font size="+1">...text that is one size larger...</font> 
You can use relative sizes or absolute sizes as shown in the table below. This 


table also lists the height in pixels for each size. The pixel sizes are for reference 
only. You cannot specify a pixel size directly in RealText. 


Font Sizes 
Relative Size Absolute Size Pixel Size Reference 
-2 1 12 pixels 
-1 2 14 pixels 
+0 (default) | 3 16 pixels 
+1 4 20 pixels 
+2 5 24 pixels 
+3 6 36 pixels 
+4 7 48 pixels 


Note: You can also specify relative sizes smaller than -2 or 
larger than +4, but they are treated as -2 and +4, respectively. 


Controlling Text Colors 


Two attributes of the <font> tag, color and bgcolor, let you set the color for the 
text letters, and the background against which the text appears. The section 
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“Setting the Window Size and Color” on page 116 explains how to set the 
RealText window’s background color. 


Setting Text Letter Colors 


The color attribute of the <font> tag lets you control the text color. It has no 
effect on tickertape windows because the <tu> and <tl> tags, which are 
described in “Aligning Text in a Tickertape Window” on page 126, set the 
tickertape text colors. The following example shows the text color set to red: 


<font color="red">...red text...</font> 


Creating Text Background Colors 


Use the bgcolor attribute to the <font> tag to set the text background color. 
The default background color for text is “transparent”, making the text 
background the same color as the window. The following example sets the text 
background to yellow: 


<font bgcolor="yellow”’>...text with yellow background...</font> 


Note that the text background color is independent of the window 
background color. If the window background color is blue, for example, and 
the text background color is yellow, a stripe of yellow appears in front of the 
blue window wherever the affected text displays. Within that yellow stripe, the 
text appears in the color set by the color attribute. 


Specifying RealText Color Values 


For RealText window backgrounds and fonts, you can use red/green/blue 
hexadecimal values (FRRGGBB), as well as the following color names, listed 
here with their corresponding hexadecimal values: 


white (#FFFFFF) silver (HCOCOCO) gray (#808080) black (#000000) 
yellow (#FFFFOO) fuchsia (#FFOOFF) red (#FFO000) maroon (#800000) 
lime (#00FFOO) olive (#808000) green (#008000) purple (#800080) 
aqua (#OOFFFF) teal (H008080) blue (HOOOOFF) navy (#000080) 


Tip: Appendix C provides background on hexadecimal color 
values. Note, though, that RealText does not support RGB 
color values used with SMIL. 
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Using Transparency as a Color 


For text backgrounds, you can use bgcolor="transparent”. This is the default for 


text backgrounds, meaning that the words following the tag do not have a 


colored rectangle drawn behind them, so the window background color shows 


around the letters. This lets you draw text over previous text (using the <pos/> 


tags) without “erasing” the previous text. 


Controlling Text Layout and Appearance 


The following tags let you lay out text in the RealText clip. Many of these tags 


are similar to HTML tags, and are provided for compatibility. However, unlike 


in HTML, RealText tags are case sensitive and a closing tag is always required. 


You cannot use a <p> tag without a </p> tag, for example, or use capital letters 


as in <P> and </P>. The following table summarizes the RealText layout and 


appearance tags. 


RealText Layout and Apperance Tags 


Tag Function Reference 
<b>...</b> Bolds the enclosed text. page 137 
<br/> Creates a line break. page 136 
<center>...</center> | Centers the enclosed text. page 136 
<hr/> Acts like two <br/> tags. page 137 
<i>...</i> Italicizes the enclosed text. page 137 
<li>...</li> Acts like a <br/> tag. page 137 
<ol>...</ol> Indents text, but does not number it. page 137 
<p>...</p> Creates a text paragraph. page 136 
<pre>...</pre> Displays text in a monospace font and preserves _| page 136 
extra spaces. Works the same as in HTML. 
<S>...</S> Strtkes-chrough the enclosed text. page 137 
<u>...</U> Underlines the enclosed text. page 137 
<ul>...</ul> Indents text, but does not add bullets to it. page 137 


Adding Space Between Text Blocks 


The following tags add space between text blocks. If text flows across the 


screen horizontally, however, line breaks are not created. 
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<p>...</p> 


The <p>...</p> tags turn the enclosed text into a pargraph. In tickertape and 
marquee windows, it causes the text that follows it to display at the window’s 
right edge. In all other window types, the <p> and </p> each cause the next text 
block to display two lines down. 


<br/> 


The <br/> tag adds space between text. In tickertape and marquee windows, it 
causes the text that follows it to display at the window’s right edge. In all other 
window types, this tag causes the text that follows to display on the next line. 


Centering Text 


The <center>...</center> tags center the enclosed text. These tags behave the 
same as HTML centering tags, but they have no effect in windows with 
horizontal motion, such as tickertape and marquee windows. The <center> tag 
forces a line break if and only if a line break caused by a tag such as <br/>, <p>, 
or <hr/> does not immediately precede it. The </center> tag always causes a line 


break. 


Note: RealText does not center text until it has determined the 
line length. In rare instances, one streamed packet may contain 
the first part of the line while another packet received several 
seconds later contains the end of the line. In this case, the first 
part displays flush left, and the entire line is centered and 
redisplayed when the second packet arrives. 


Preformatting Text 


The <pre>...</pre> tags work the same as in HTML. Text tagged with <pre> 
uses the Courier font at the current size. To change the font size, precede the 
preformatted block with a <font size="n"> tag. Line breaks, spaces, and tabs are 
preserved, with tabs defaulting to 64 pixels for 16 point text (the normal point 
size). Tab spaces are determined by dividing the text height by 2, then 
multiplying by 8. 


For More Information: For information on text heights, see the 
table “Font Sizes” on page 133. See also “Ignoring Extra 
Spaces” on page 122. 
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Using HTML-Compatible Tags 


<ol>.. 


<ul>.. 


The following RealText tags are provided for HTML compatibility, allowing 
you to convert HTML to RealText more easily, and vice versa. These tags do 
not function the same in RealText as they do in HTML, however. 


.</ol> 
The <ol>...</ol> tags are for compatibility with HTML lists. Text between these 


tags is indented, but not numbered. 


</ul> 
The <ul>...</ul> tags are for compatibility with HTML lists. Text between these 
tags is indented, but not bulleted. 


<li>...</li> 
The <li>...</li> tags are for compatibility with HTML lists. They act like a 
<br/> tag. 

<hr/> 
The <hr/> tag is for compatibility with HTML horizontal rules. It acts like two 
<br/> tags. 

Emphasizing Text 

The following RealText tags let you add emphasis to text. 

<b>...</b> 
The <b>...</b> tags display the enclosed text bolded. 

<i>...</i> 
The <i>...</i> tags display the enclosed text italicized. 

<s>...</s> 
The <s>...</a> tags strike through the enclosed text. 

<u>...</u> 


The <u>...</u> tags display the enclosed text underlined. 
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Creating Links and Issuing Commands 


The following sections describe tags you can use to launch URLs through 
RealText. You can also use tags to issue RealOne Player commands such as 
Pause and Play. The following table summarizes link and command syntax. 


RealText <a> Tag Attributes 


Attribute Value Function Reference 

href=“command” command:seek(time)| | Issues a page 140 

target="_player” command:pause()| command. 
command:play() 

href=“command:openwindow()” |name|URL| Opens new page 383 
zoomlevel windows 

href=“mailto:address” email_address Opens e-mail | page 138 

message. 
href="URL" target="_player” Links to URL. | page 138 


Tip: Text in a link uses the color specified in the link attribute 
of the <window> tag. The link is underlined unless the <window> 
tag includes underline_hyperlinks="false”. 


For More Information: SMIL files can also define hypertext links 
that may override the link you set here. For more information, 
see Chapter 15. 


Creating a Mail Link 
This tag turns the enclosed text into an e-mail hyperlink: 
<a href=“mailto:address”>...</a> 


When the viewer clicks the link, RealText opens the viewer’s default mail 
application. Use an address in the standard form, such as name@company.com. 
In most cases, the e-mail application opens a new message with the defined 
address in the “to” line. 


Opening Media or HTML Pages 


The following RealText tag turns the text enclosed between <a href...> and 
</a> into a hyperlink that opens an HTML page or a media clip: 


<a href=“URL” [target="_player”]>...</a> 
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The specified URL should begin with a protocol designation such as http:// or 
rtsp://. The optional target="_player” attribute launches the new stream in the 
media playback pane. If you do not use the target attribute, or you specify 
target="_browser”, the linked URL opens in RealOne Player’s media browser 
pane, or in the viewer’s default Web browser with earlier versions of RealPlayer. 


Example 1: Opening a Streaming Media URL 


The following example launches a new SMIL Presentation in RealOne Player, 
replacing the currently playing presentation: 


<a href=“rtsp://helixserver.example.com/video2.smil target="_player”>Play Next</a> 


You can also open a link in a new media window that pops up above the media 
playback pane. This lets you keep navigation information visible in the media 
playback pane, for example, while content plays in a new window. For more 
about this, see “Opening a Media Playback Window with a Clip Link” on page 
383. 


Example 2: Opening an HTML Page 


This example opens a URL in the media browser pane of RealOne Player, or in 
the viewer’s default Web browser with earlier versions of RealPlayer: 


<a href=“http://realguide.real.com”>Visit RealGuide</a> 


You can also specify URLs relative to the location of the RealText source file. 
For example, the link <a href="more.htm”>...</a> opens the file more.htm in the 
same directory as the RealText file. Relative links follow the standard HTML 
directory syntax. 


Note: With RealOne Player, you cannot target the related info 
pane or a secondary browsing window. 


Example 3: Opening a URL in the Form protocol:path 


If you include version="1.5" (or higher if using a newer version of RealText) in 
the <window> tag, you can open a URL in the form protocol:path instead of 
protocol://path. Protocols using this format include those for Telnet and AOL 
Instant Messenger. For example, here is a RealText link that launches AOL 
Instant Messenger: 

<window version="1.5"...> 


...<a href="aim:goim?screenname=[name]”>Send Me an Instant Message</a>... 
</window> 
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Issuing RealOne Player Commands 


The following tag makes the enclosed text a hyperlink that, when clicked, 
executes a RealOne Player command: 


<a href=“command” target=“_player”>...</a> 


The commands are case-sensitive and must be enclosed in double quotes. The 
target="_player” attribute is required. 


Seeking Into a Presentation 


The following command instructs RealOne Player to seek to the specified time 
in the current text stream: 


<a href="command:seek(time)” target="_player”>Seek</a> 


For example, the following instructs RealOne Player to seek to 1:35.4 in the 
stream: 


<a href="command:seek(1:35.4)” target="_player”>Seek</a> 


Pausing a Presentation 
When clicked, the following link causes RealOne Player to pause the stream: 


<a href="command:pause()” target="_player”>Pause</a> 


Resuming Playback 


Clicking the next link causes RealOne Player to begin or resume playing the 
stream: 


<a href="command:play()” target="_player”>Resume</a> 


Using Coded Characters 


The following table lists the character codes you can include in a RealText 
source file. Codes begin with an ampersand (“&”) and end with a semicolon 
(“;"). RealText interprets these characters the same way as popular Web 


browsers. 
RealText Coded Character Set 
Code Displays as 
&lt; < 
&gt; > 


(Table Page 1 of 2) 
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RealText Coded Character Set (continued) 


Code Displays as 

&amp; & 

&nbsp; (nonbreaking space) 

&#32; Characters taken from the active character set as specified by the active 
to <font charset=”"...”> tag. The default character set is iso-8859-1, which is 


&#255; | also known as ISO Latin 1. For a list of these characters, see the W3C 
reference at http://www.w3.org/MarkUp/html-spec/html- 
spec_13.html. See below, however, if you’re using the mac-roman 
character set. 


(Table Page 2 of 2) 


Tip: The zipped HTML version of this guide includes a 
JavaScript file that generates the character codes for you. See 
“How to Download This Guide to Your Computer” on page 12 
for details about getting the zipped HTML manual. 


For example, the following RealText source text: 
This is a bold tag: “&lt;b&gt;”. 
is displayed in a RealText window as: 


This is a bold tag: “<b>”. 


Using Coded Characters with the mac-roman Character Set 


Unlike HTML, RealText allows you to change character sets within a 
document. It then takes coded characters from the active character set. 
Generally, character codes 128 and lower are the same in all Western-language 
character sets. Those higher than 128 may differ, though. In the mac-roman 
character set, for example, &#166; is a paragraph symbol. But in iso-8859-1, this 
symbol is &#182;. 


See http://czyborra.com/charsets/mac-roman.gif for a GIF chart of the 
mac-roman upper character set. Go by this chart, rather than the W3C reference 
provided above if you’ve set <font charset="mac-roman”> and are entering coded 
characters of &#129; or higher. The values in the chart are in hexadecimal (base 
16). The chart cell in the upper, left-hand corner equals 128 in decimal (base 
10), so you can count across from there. To make a paragraph symbol when 
using mac-roman, for instance, you use &#166; in the RealText file because 
hexadecimal A6 on the chart is decimal 166. 
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This following sections provide examples of how to create various types of 
RealText clips. 


Generic Window 


The following sample RealText markup creates a generic RealText window: 


<window duration="30” bgcolor="yellow’> 

<br/>Mary had a little lamb, 

<br/><time begin="3"/>Little lamb, 

<br/><time begin="6"/>Little lamb. 

<br/><time begin="9"/>Mary had a little lamb, 
<br/><time begin="12"/>whose fleece was white as snow. 
<br/><time begin="15"/><clear/><br/>Everywhere that Mary went, 
<br/><time begin="18"/>Mary went, 

<br/><time begin="21"/>Mary went, 

<br/><time begin="24”"/>Everywhere that Mary went, 
<br/><time begin="27"/>That lamb was sure to go. 
</window> 


When RealOne Player processes this file, it displays only the first line of the 
text from zero to three seconds into the stream: 


Mary had a little lamb, 


Every three seconds after the first line displays, a new line appears as specified 
by <time begin="n"/>. At 15 seconds, <clear/> clears the displayed text and 
resets the text “cursor” to the upper-left corner of the window. When the 
stream finishes, all lines of text following the last <clear/> tag appear in the 


window: 
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Everywhere that Mary went, 
Mary went, 

Mary went, 

Everywhere that Mary went, 
That lamb was sure to go. 


Note the following about this sample clip: 


- Because it was not specified in the <window> tag, word wrapping defaults 
to true. However, word wrapping is not necessary because <br/> tags force 
line breaks. 


+ <time/> tags need not appear after a <br/> tag. They can appear anywhere 
in the text. 


+ The example could have used <time end=”..."/> tags to make individual 
lines of text disappear before the <clear/> tag cleared all the lines. 


Tickertape Window 


The following example shows the RealText markup for a tickertape window. 
This is the RealText (.rt) source file: 


<window type="tickertape” duration="1:00”" width="500” loop="true” 
underline_hyperlinks="false” link="white”> 

<br/> 

<b> 

<tu><a href="http://www.dowjones.com/”>DJIA</a></tu> 
<tl>7168.35 +36.5 </tl> 

<tu>NIKEI 225 Index</tu> 

<tl>20603.71 +203.11</tl> 

</b> 


</window> 


This source file produces the following window in RealOne Player: 


NIKEI 225 Index 


JIA 
716835 +3652 20603.71 +203.11 


Note the following about this sample clip: 


- The text crawls from right to left at 20 pixels per second, the default 
crawlrate for a tickertape window. 
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+ The <b> tag at the start bolds all following text. 


+ <a href="http://www.dowjones.com/">DJIA</a> makes DJIA a hyperlink that, 
when clicked, opens the URL http://www.dowjones.com/. 


+ DJIA is not underlined because underline_hyperlinks="false” is declared in 
the <window> tag. It is drawn in white because link="white” is also in the 
<window> tag. 


The attribute loop="true” in the <window> tag means the text loops around 
and comes back in from the right side of the window as soon as the last 
character of the text has moved completely out of the window. It is not 
necessary to specify this attribute explicitly, because in tickertape windows 
loop="true” is the default. 


The <br/> tag that comes before the first text item forces the text that 
follows to start just past the window’s right edge. Any break or paragraph 
tag inside tickertape text causes the text that follows to start at the right 
edge. If the <br/> tag were absent, the data would appear starting at the 
window’s left edge. 


Scrolling News Window 


The following sample RealText markup creates a scrolling news window: 


<window type="scrollingnews" width="240" height="180" scrollrate="20" 
duration="25" bgcolor="#4488DD"> 

<p></p><p></p><p></p> 

<font face="System"><b><u>Seattle--February 28, 2001</u></b> 

<p>A powerful earthquake of magnitude 6.8 rocked Seattle at 10:55 A.M.</p> 
<p>Initial reports list no fatalities, and traffic is moving on Interstate 5.</p> 
<p>Some damage has occurred to buildings in the historic Pioneer Square area.</p> 
<p>Seattle mayor Paul Schell is expected to announce a press conference.</p> 
</font> 

</window> 


The following figure shows the RealText window at nine seconds into the 
presentation: 
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Seattle—February 28, 2001 


A powerful earthquake of magnitude 6.8 rocked 
Seattle at 10:55 A.M. 


Initial reports list no fatalities, and traffic is 
moving on Interstate 5. 


Tip: Text in a scrolling news window normally starts at the top 
of the window and scrolls up. As this sample shows, you can 
precede the text with <p></p> tags to push the first line of text 
to the bottom of the screen. 


Teleprompter Window 


The following example demonstrates a TelePrompter window. This is the 
RealText (.rt) source file: 


<window type="teleprompter” height="64”" duration="25” 
bgcolor="#D2F8B4” extraspaces="ignore” wordwrap="false”> 
<font face="system”> 

Out, out, brief candle! 

<br/><time begin="3.5”"/>Life's but a walking shadow, a poor player 
<br/><time begin="7"/>That struts 

<time begin="8"/>and frets 

<time begin="9"/>his hour upon the stage 

<br/><time begin="12”/>And then is heard no more: 

<time begin="15"/>it is a tale 

<br/><time begin="16”"/>Told by an idiot, 

<time begin="17.5"/>full of sound and fury, 

<br/><time begin="20"/>Signifying 

<time begin="22”"/><font color="red”>nothing.</font></font> 
</window> 


When the window fills with text and a new line appears, all lines scroll up to 
make room for the new line. The following illustrates the window when the 
presentation ends: 
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That struts and frets his hour upon the stage 
And then is heard no more: itis a tale 
Told by an idiot, full of sound and fury, 
Signifying nothing. 
Note the following about TelePrompter windows: 

« The wordwrap attribute can be true or false. 


+ The scrollrate and crawlrate attributes are ignored. 


- You can use a <clear/> tag to clear the window and start the next line at 
the window's upper, left-hand corner. 


- Use <time begin/> tags at the start of each line and do not let word 
wrapping cause too many line breaks between <time/> tags. 


+ Multiple lines of text with the same begin time cause the preceding text to 
move up until all new lines appear at the bottom of the window. 
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REALPIX MARKUP 


Using RealPix markup, you can create streaming slideshows from 
still images in JPEG, GIF, and PNG formats. You can even define 
transition effects, such as fades and wipes, that occur between 
images. Coupled with an audio soundtrack, RealPix makes a viable 
alternative to video for low-bandwidth connections. This chapter 
explains the RealPix markup. Appendix F provides a quick reference 


for RealPix tags and attributes. 


For More Information: RealSlideshow provides a graphical user 
interface for creating RealPix presentations. See 
“RealSlideshow Presentations” on page 43. 


Tip: To see RealPix examples, get the zipped HTML version of 
this guide as described in “How to Download This Guide to 
Your Computer” on page 12, and view the Sample Files page. 


Understanding RealPix 


A RealPix slideshow consists of a RealPix markup file, which uses the file 
extension .rp, along with any number of images. For each slideshow, you 
define an overall duration, and indicate when each image appears during the 
presentation timeline. RealPix automatically expands or shrinks each image to 
fit in a display area that can be any size. The markup also lets you define 
several transition effects: 


- Fade an image in from a solid color. 
- Fade an image out to a solid color. 

* Crossfade between two images. 

+ Display only part of a source image. 


+ Introduce a new image with a wipe from left to right, for example. 
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Zoom in on a detail, pan around the image, or zoom out. 


RealPix and SMIL 


You can stream a RealPix slideshow by itself, or you can use SMIL to combine 


RealPix with other clips, such as a RealAudio soundtrack. Using SMIL 2.0, you 


can 


augment your slideshow with many features. If you stream a slideshow 


alongside a video sequence, for example, you can use SMIL transition effects 


to fade the videos in and out. In fact, because SMIL 2.0 provides transition 


effects, you can use just SMIL 2.0 to assemble a slideshow. As the following 


sections explain, though, RealPix and SMIL 2.0 offer different advantages for 


delivering slideshows. 


RealPix Slideshow Advantages 


A streaming slideshow created with RealPix provides the following advantages 
over a slideshow defined through SMIL 2.0: 


backwards compatibility 


RealPix is compatible with RealPlayer versions earlier than RealOne 
Player, such as RealPlayer 7 and RealPlayer 8. SMIL 2.0 works only with 
RealOne Player and later. To coordinate multiple clips, you can use SMIL 
1.0 along with RealPix to reach the widest RealPlayer audience. 


For More Information: For more on the two versions of SMIL, 
see “SMIL 1.0 and SMIL 2.0” on page 193. 


better resource use 


RealPix maximizes the efficiency of image streaming. Now matter how 
many images the slideshow contains, a RealPix presentation needs just 
one stream from Helix Universal Server. In contrast, a SMIL 2.0 slideshow 
may require a separate Helix Universal Server stream for each image in the 
slideshow. RealPix is better suited, therefore, for long slideshows that 
contain a lot of images. 


easier timeline and bandwidth management 


Under stable network conditions, RealPix guarantees that RealOne Player 
does not have to pause the slideshow to buffer more data. It does this by 
gauging the bandwidth required to stream all of the images against the 
slideshow timeline. It then streams enough preroll data to ensure that the 
slideshow does not have to pause once it begins to play. Achieving the 
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same results using SMIL 2.0 may require the use of advanced SMIL 
features such as prefetching, which Chapter 19 explains. 


image caching in memory 


If you reuse an image in a RealPix slideshow, RealOne Player caches the 
image in memory until it is no longer needed. A RealPix slideshow can 
thereby redisplay images without consuming more bandwidth. A RealPix 
slideshow does not have access to the cache of another slideshow playing 
concurrently, though, and each cache is deleted when the slideshow ends. 


Note: No version of RealPlayer maintains a disk cache of 
images shown in a RealPix or SMIL presentation. Nor can 
viewers copy or download images. Viewers therefore do not 
have access to copyrighted image files shown in a RealPix or a 
SMIL 2.0 presentation. 


easier markup for complex effects 


RealPix lets you display just part of a source image, zoom in or out on an 
image, and pan across an image. Although you can duplicate these effects 
using SMIL layout and animations, which are described in Chapter 12 and 
Chapter 17, respectively, the RealPix markup lets you create these effects 
more easily. 


SMIL 2.0 Slideshow Advantages 
Creating a slideshow with SMIL 2.0 alone provides these advantages over 
using RealPix: 
+ single markup file 
Your SMIL 2.0 file will contain all the required presentation markup. This 
can make it easier to coordinate each image with, for example, a separate 
audio clip. When you use RealPix, you need a RealPix file to define the 


slideshow, and a SMIL file to coordinate the slideshow with other clips, 
such as the soundtrack. 


more transition effects 


As Chapter 16 explains, SMIL 2.0 provides over 100 styles of transition 
effects. You can run each transition effect in a forward or reverse direction, 
for example, or use partial or repeating effects. You can also apply SMIL 
transition effects to any type of visual clip, including Flash animations 
and videos. RealPix, on the other hand, provides about a dozen transition 
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effects for still images only. It doesn’t offer extra features found in SMIL 
transition effects, such as border colors and blends. SMIL 2.0 therefore 
lets you create a more visually unique slideshow. 


* interactive slideshows 


Using exclusive groups and SMIL 2.0’s advanced timing features, you can 
create an interactive slideshow that advances to a new image only when 
the viewer clicks a button, for instance. RealPix slideshows, on the other 
hand, always display images automatically according to the predefined 
RealPix timeline. 


For More Information: For more on SMIL exclusive groups, see 
“Creating an Exclusive Group” on page 259. Chapter 14 covers 
advanced SMIL timing. 


Image Formats and Features 


For a RealPix presentation, you can use illustrations, scanned images, or 
pictures taken with a digital camera. Images can be in JPEG, PNG, GIF, or 
animated GIF format. You'll likely need image editing software such as Adobe 
Photoshop to prepare images. You should know the basics of creating 
graphics for the Web, such as JPEG compression and GIF color palettes. When 
preparing your presentation, maintain three sets of images: 


1. original set 


The original set includes the unedited files you start with, such as original 
images off a scanner. Keep this set in case you need to change an image in 
the working set by, for example, restoring an area you cropped out. Leave 

these images uncompressed. 


2. working set 


The working set comprises the files that you have edited. You may want to 
crop the original images, for example, or combine them to form new 
images. Keep these files uncompressed so that you can edit them further 
if necessary. 


Tip: Images do not need to be the same sizes. By default, 
RealPix expands or shrinks all images to fit a predefined 
display area. 
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3. presentation sets 


A presentation set consists of the compressed files (GIF, JPEG, or PNG) 
used in the presentation. For a given working set, you may have several 
presentation sets. For instance, you may have slightly compressed images 
for a high-bandwidth presentation, heavily compressed images for a low- 
bandwidth version. 


For More Information: The section “Images” on page 42 provides 
details on the supported image formats. The section 
“Controlling an Animated GIF Image” on page 175 explains 
how to start a GIF animating within a slideshow. 


JPEGTRAN for JPEG Images 


JPEGTRAN is a freeware program that optimizes JPEG (.jpg) images for 
streaming with RealPix. It modifies them so that if a packet of image data is 
lost, RealOne Player can still decode and display remaining packets. If you do 
not use JPEGTRAN on your images, RealOne Player cannot decode packets 
following a lost packet, and a substantial part of the image may not display. 
JPEGTRAN is included in the utilities folder of the zipped HTML version of 
this manual. You can also run JPEGTRAN from the RealPix bandwidth 
calculator, which is also included in the utilities folder. 


Tip: Because running JPEGTRAN may increase or decrease the 
image file sizes slightly, run this program on your JPEG images 
before you calculate the image streaming times, as described in 
“Managing RealPix Bandwidth” on page 154. 


For More Information: See “How to Download This Guide to 
Your Computer” on page 12 for instructions on getting a local 
copy of this guide. 


Image Transparency 


When you stream a RealPix slideshow to RealOne Player, transparent areas in 
GIF and PNG images show underlying images or background colors within 
the slideshow. Transparency does not extend to underlying SMIL regions, 
though. So if your RealPix presentation appears in front of a video in a SMIL 
presentation, the video does not show through transparent image areas. 
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RealPix Timelines 


If your presentation consists solely of streaming RealPix images, you have full 
control over the RealPix timeline. When you combine RealPix with another 
clip such as RealAudio, however, you may want to display the RealPix images 
at specific points in the other clip’s timeline. In these cases, finish the other 
clip first, then assemble your RealPix presentation so that it coordinates with 
the other clip’s final timeline. 


When working with an audio track, for example, think about the order of the 
images, deciding at which points in the audio timeline each image must 
display. When you are ready to assemble your RealPix presentation, play back 
the audio and note where you want to add each image. This will establish your 
RealPix timeline. 


Once you have determined a timeline for your presentation, and have decided 
how to show the images, you are ready to create a RealPix presentation. You 
may find it easier to create a storyboard to lay out the images and transition 
effects. Or you may want to dive right in, using the presentation in progress as 
your guide. Either way, carefully consider the bandwidth implications as you 
place your images and set the start times and durations. 


For More Information: See “Managing RealPix Bandwidth” on 
page 154. The section “Step 5: Organize the Presentation 
Timeline” on page 52 explains issues involved with multiclip 
timelines. 


Structure of a RealPix File 


A RealPix file is a plain text file that uses the file extension .rp. The RealPix 
markup starts with the <imfl> tag, and ends with the </imfl> tag. The following 
example shows a simple RealPix file with the most basic attributes. This 
sample simply fades in two images in sequence, then fades out to a solid blue: 


<imfl> 
<head title="RealPix Example" 
copyright="(c)2002 RealNetworks, Inc." 
background-color="black" 
timeformat="dd:hh:mmi:ss.xyz" 
duration="15" 
bitrate="12000" 
width="256" 
height="256"/> 

<!-- Assign handle numbers to images. --> 
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<image handle="img1" name="rtsp://helixserver.example.com/image1.jpg'/> 
<image handle="img2" name="rtsp://helixserver.example.com/image2.jpg'/> 
<!-- Fade in images. --> 
<fadein start="1" duration="3" target="img1"/> 
<fadein start="4" duration="3" target="img2"/> 
<!-- Fade out to a solid blue. --> 
<fadeout start="8" duration="3" color=“blue“/> 
</imfl> 


RealPix requires a <head/> tag that defines overall presentation attributes, 
such as the duration, the display area size, and the streaming bit rate. After the 
<head/> tag, <image/> tags define each image used in the presentation, and 
assign each image a unique ID (its “handle”). Effects tags such as <fadein/> 
select an image handle, and define the RealPix timeline through their start 
attributes. Not all effects specify an image, though. A <fadeout/> tag, for 
instance, specifies a fade color rather than an image handle. 


Rules for RealPix Markup 


The syntax rules for RealPix markup are similar to those for RealText and 
SMIL: 


- RealPix tags and attribute names must be lowercase. 


- A tag that does not have a corresponding end tag closes with a forward 


slash (/): 
<fadein.../> 


In RealPix, only the <imfl> tag, which uses the end tag </imfl>, does not 
close with a slash. 


- Attribute values must be enclosed in double quotation marks. 


- Unless noted otherwise, the order of attributes following the tag name 
does not matter. 


- You can add a comment like the following to a RealPix file. Note that a 
comment tag does not require a closing slash: 


<!-- This is a comment --> 


RealPix Broadcast Application 


You do not have to create RealPix slideshows through static markup files. A 
broadcast application can monitor a folder for new images, and broadcast 
them through Helix Universal Server as part of a live RealPix presentation. A 
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sample broadcast application is included with the Software Development Kit 
(SDK) available for download at this Web page: 


http://proforma.real.com/rnforms/resources/server/realsystemsdk/ 
index.html 


Managing RealPix Bandwidth 
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When you stream your RealPix presentation to viewers over a network, you 
need to consider the bandwidth (bit rate) the presentation will consume. You 
don’t need to consider bandwidth if copies of the presentation files will reside 
on each viewer’s desktop computer, however. This section helps you to 
determine your presentation’s bandwidth usage, which can affect how you 
construct the RealPix timeline, and helps you decide how large to make your 
slideshow images. 


Tip: The easiest way to calculate the streaming times for each 
image is to use the RealPix bandwidth calculator. This 
calculator is included in the utilities folder of the zipped 
HTML version of this manual. See “How to Download This 
Guide to Your Computer” on page 12 for instructions on 
getting a local copy of this guide. 


Estimating the Required Bandwidth and Preroll 


The table “Maximum Streaming Rates” on page 47 lists the maximum 
recommended streaming rates for different network connections. To reach 
viewers with 56 Kbps modems, for example, a presentation should not require 
more than 34 Kilobits of data per second. When you stream RealPix together 
with another clip, such as a soundtrack, you must take into account the 
bandwidth required by each clip. If you use a 16 Kbps RealAudio soundtrack, 
for instance, you have 18 Kbps left for RealPix images when streaming over 56 
Kbps modems (34-16=18). 


The bandwidth your RealPix presentation consumes depends on the total size 
of the image files and the presentation length. To get a rough estimate of this 
bandwidth, add together the sizes of all image files used in the presentation. 
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Convert this total to Kilobits using the chart below. Then divide by the 
RealPix presentation length in seconds. 


Converting File Size to Kilobits 


Using This Measurement Do This to Get Kilobits 
Megabytes Multiply by 8192 
Kilobytes Multiply by 8 

bytes Divide by 128 

bits Divide by 1024 


For example, if your image files add up to 200 Kilobytes, multiply 200 by 8 to 
get 1600 Kilobits. A presentation that lasts two minutes, for instance, uses an 
average of 13.3 Kilobits per second: 


(200 Kilobytes x 8)/120 seconds = 13.3 Kilobits per second 


If your RealPix target is 18 Kbps, your presentation should stream smoothly 
with bandwidth to spare. Suppose that the image files add up to 300 
Kilobytes, however. In this case, the average streaming speed required is 20 
Kbps, which exceeds the 18 Kbps target: 


(300 Kilobytes x 8)/120 seconds = 20 Kilobits per second 


This slideshow can still stream over a 56 Kbps modem, but it may have a 
longer preroll (initial buffering) than desired. RealPix calculates how much 
image data must stream to RealOne Player before the slideshow starts in order 
to keep the slideshow from rebuffering once it begins to play. In other words, 
if your slideshow has too much image data to stream during the length of its 
timeline, excess data streams before the slideshow starts to play. The viewer, 
though, must wait for this data to arrive before the slideshow can commence. 


To illustrate the effects of preroll, suppose that you plan to stream a two- 
minute slideshow at 18 Kbps. This presentation can deliver 2,160 Kilobits of 
data (18 x 120). If the images add up to 300 Kilobytes (2,400 Kilobits), the 
presentation has an extra 240 Kilobits of data to stream. At 18 Kbps, this 
means 13 seconds or longer of preroll. In this situation, you can either accept 
the longer preroll, which may tempt viewers to quit the slideshow before it 
starts, or modify the slideshow to use less bandwidth. 


For More Information: “Buffering” on page 46 explains the 
basics of preroll. For tips on how to modify or manage preroll, 


155 


RealNetworks Production Guide 


156 


see “Lowering RealPix Preroll” on page 157 and “Masking 
Preroll With Other Clips” on page 157. 


Calculating Individual Image Streaming Times 


Dividing the total image size by the presentation length provides only a rough 
estimate for preroll. It assumes that all images are about the same size, are 
streamed at regular intervals, and appear only once. You may still run into 
excess preroll, though, if you use large images, or a lot of images, early in the 
slideshow timeline. To prevent this, ensure that each image has enough time 
to stream to RealOne Player before it must display. The following table helps 
you to estimate how much time is required to stream an image over a 56 Kbps 
modem (maximum streaming rate of 34 Kbps), when you combine RealPix 
with various RealAudio soundtracks. 


Data Streaming Times Over a 56 Kbps Modem 


Streaming Time for Data Streamed 
RealAudio Codec _ RealPix Bandwidth Each Kilobyte of Data Every 5 Seconds 
No Audio 34 Kilobits/second _| 0.24 seconds 20.8 Kilobytes 
6 Kbps Music 28 Kilobits/second | 0.29 seconds 17.2 Kilobytes 
8 Kbps Music 26 Kilobits/second _| 0.31 seconds 16.1 Kilobytes 
11 Kbps Music 23 Kilobits/second | 0.34 seconds 14.7 Kilobytes 
16 Kbps Music 18 Kilobits/second | 0.5 seconds 10 Kilobytes 
20 Kbps Music 14 Kilobits/second 0.57 seconds 8.8 Kilobytes 


The table indicates that if you use an 8 Kbps RealAudio music soundtrack, for 
example, you have 26 Kilobits per second of bandwidth available for Realpix 
images. At this rate, it takes about 0.31 seconds to stream each Kilobyte of 
image data. If an image is 44 Kilobytes, for example, it requires about 13.6 
seconds (44 x 0.31) to stream to RealOne Player. The first time this image 
appears in the slideshow, it should follow the preceding image by 14 seconds 
or more. For convenience, the last table column indicates how much image 
data can stream to RealOne Player approximately every five seconds. 


Note: Once RealOne Player has received a RealPix image, it 
caches the image in memory, so you can reuse the image within 
the same slideshow without having to stream the image data 
again. RealOne Player deletes this cache when the slideshow 
ends. 
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Lowering RealPix Preroll 


If your RealPix presentation requires excessive preroll, you can alter the 
images, modify the timeline, or both. Whenever you alter images, be sure to 
test that your slideshow retains acceptable image quality. The following are 
some tips for lowering the slideshow’s bandwidth consumption: 


+ Crop out unnecessary portions of your images to reduce the image file 
sizes. The smaller the file, the faster it streams. 


- Because an image automatically expands to fill the RealPix display area, 
you can reduce the image dimensions to lower its bandwidth requirement. 
You then let RealOne Player expand the image during playback. 


+ Reduce the resolution and number of colors in images while maintaining 
satisfactory image quality. For JPEG files, experiment with higher 
compression rates. 


- Use smaller images at the beginning of the presentation. They will stream 
to RealOne Player faster, and Helix Universal Server can use the extra 
bandwidth to start streaming larger files needed later. 


+ Introduce images gradually over the timeline. Don’t use rapid effects with 
a lot of images at the beginning of the presentation. Once you have 
displayed all images, however, you can use rapid effects because RealOne 
Player holds the image data in memory. 


+ Increase the length of the presentation by, for example, adding an extra 
second to the start time of each effect. 


Masking Preroll With Other Clips 


You can stream a low-bandwidth clip ahead of your slideshow to mask the 
RealPix preroll. For example, you can start the presentation with a RealText 
clip that displays opening credits. Or you can use a low-bandwidth RealAudio 
voice clip as a narration. As these introductory clips play, Helix Universal 
Server takes advantage of the extra bandwidth to stream the RealPix preroll. 
To set this up, you assemble the overall presentation using SMIL, placing all 
clips in a parallel group, and setting a delay for the RealPix clip with a begin 
attribute: 
<par> 
<textstream src="credits.rt” region="credits_region” dur="15s” fill="remove”/> 
<ref src="slideshow.rp” region="slides_region” begin="15s"/> 
</par> 
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For More Information: See Chapter 6 for more on RealText. The 
section “Playing Clips in Parallel” on page 249 explains <par> 
groups. See “Setting Begin and End Times” on page 314 for 
more on the begin attribute. 


Setting Slideshow Characteristics 


All information in the RealPix file falls between an opening <imfl> tag and a 
closing </imfl> tag. This is the only tag in the RealPix markup that uses an end 
tag. The <head/> tag follows the <imfl> tag in the RealPix file. Unlike the 
HTML <head> tag, the RealPix <head/> tag does not have a corresponding 
</head> tag. Instead, it closes with a slash: 
<imfl> 

<head...attributes.../> 


...RealPix images and transition effects... 
</imfl> 
The <head/> tag sets standard presentation information such as the title, 
author, and copyright. It also defines necessary parameters such as the 


presentation’s duration and streaming bit rate. The following table 
summarizes all <head/> tag attributes. An asterisk (*) indicates a required 


attribute. 

RealPix <head/> Tag Attributes 
Attribute Value Function Reference 
aspect false|true Handles image aspect ratios. page 163 
author text Gives the name of the author. page 161 


background-color | name|#RRGGBB | Sets an initial background color. | page 161 


bitrate* bits_per_second | Indicates required bandwidth. page 161 
copyright text Gives the copyright notice. page 161 
duration* time_value Sets the presentation duration. page 160 
height* pixels Specifies the presentation height. | page 159 
maxfps integer Sets the maximum frames per page 164 
second for transition effects. 
preroll seconds Allots time for initial buffering. page 162 
timeformat milliseconds| Indicates the format of time page 159 


dd:hh:mm:ss.xyz | attributes. 


title text Gives the presentation title. page 161 
(Table Page 1 of 2) 


158 


CHAPTER 7: RealPix Markup 


RealPix <head/> Tag Attributes (continued) 


Attribute Value Function Reference 


url URL Sets a hyperlink URL for images. | page 163 
width* Specifies the presentation width. | page 159 


(Table Page 2 of 2) 


Defining the Presentation Size 


The required width and height attributes set the size of the image display area 
in pixels. By default, all images are centered within this area, and enlarged or 
reduced so that no cropping occurs. The aspect attribute determines whether 
distortion may occur, though. The following example creates a RealPix 
playback area 256 by 256 pixels: 


<head width="256” height="256".../> 


When you stream just RealPix, RealOne Player’s media playback pane expands 
to the specified size when the slideshow begins. When you play RealPix with 
another clip, you lay out playback regions with SMIL. You typically create for 
the slideshow a SMIL playback region that uses the same width and height set 
in the RealPix markup. If the SMIL region is a different size, the region’s fit 
attribute determines how to handle the size difference, such as by scaling or 
cropping the entire display area. 


For More Information: Chapter 12 describes SMIL layouts in 
general. See “Fitting Clips to Regions” on page 301 for more on 
the fit attribute. 


Specifying the Time Format 


The timeformat attribute sets the format the for start and duration attributes 
used with RealPix effects. RealPix can specify time values in milliseconds or 
“normal play time” format, but not with SMIL shorthand timing values such 
as “2s”. The default time format is milliseconds, which means that a time value 
such as 5400 is read as 5400 milliseconds (5.4 seconds). Millisecond time 
values cannot include colons or a decimal point. 


You can also set timeformat to the normal play time format: 


<head timeformat=“dd:hh:mm:ss.xyz”.../> 


Here, dd is days, hh is hours, mm is minutes, ss is seconds, x is tenths of 
seconds, y is hundredths of seconds, and z is milliseconds. Only the ss field is 
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required. With this format, for instance, duration="3" sets a three-second 
duration. 


When the time value does not include a decimal point, the last field is read as 
the seconds. For example, 1:30 means 1 minute and 30 seconds, whereas 
1:30:00 means 1 hour and 30 minutes. Note that with the normal play time 
format, all of the following values are equivalent. Each starts the effect 90 
minutes after the RealPix presentation begins: 

start="1:30:00.0" 

start="90:00" 

start="5400" 


Setting the Presentation Duration 


The required duration attribute sets the length of the entire RealPix 
presentation, using the time format specified in the timeformat attribute. For 
example, the following value sets a duration of 50 seconds: 


<head timeformat=“dd:hh:mm:ss.xyz” duration="50".../> 


All RealPix effects stop immediately when the duration elapses. When the 
duration time exceeds the time required to complete the effects, the last effect 
stays frozen onscreen until the duration elapses. 


Tips for Setting a RealPix Duration 


- As you develop your RealPix presentation, set a high duration. Once you 
have finished the timeline, adjust the presentation duration. If you 
introduce the last image at 90 seconds into the timeline, for example, you 
may want to set a presentation duration of 95 seconds or higher. 


- If your slideshow stops playing before all images have displayed, you 
probably need to increase the presentation duration, or change the 
timeformat attribute in the <head/> tag. 


+ RealOne Player reflects the duration you set. If you set a duration of five 
minutes, for instance, the RealOne Player status bar lists the presentation 
length as 5:00.0 and the RealOne Player position slider takes five minutes 
to travel from left to right. 


- A presentation duration set much higher than the time it takes all images 
and effects to display may unnecessarily delay clips that play after the 
RealPix slideshow in a SMIL sequence. A high duration can also make it 
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difficult for viewers to use the RealOne Player position slider to search for 
specific parts of the slideshow. 


+ Within a SMIL presentation, the SMIL dur attribute can shorten the time 
that the slideshow plays, effectively overriding the RealPix duration 
attribute. See “Setting Durations” on page 317 for more about dur. 


Controlling the Streaming Bit Rate 


The required bitrate attribute specifies the maximum bandwidth the RealPix 
presentation consumes. Specify the value in bits per second (bps). For 
example, the following value sets a maximum bandwidth of 12000 bps 
(approximately 12 Kbps): 

<head bitrate="12000".../> 


Tip: To convert precisely from Kilobits per second to bits per 
second, multiply by 1024. 


For More Information: “Managing RealPix Bandwidth” on page 
154 explains how to calculate bandwidth requirements for a 
RealPix presentation. 


Defining the Title, Author, and Copyright 


The optional title, author, and copyright attributes define information for the 
RealPix presentation: 


<head title=“My RealPix Slideshow” author="Pat Morales” 
copyright=“(c) 2002 RealNetworks Media Productions”.../> 


When present, these attributes define the values that display for the RealOne 
Player clip information (View>Clip>Clip Info). If the RealPix presentation is 
played through a SMIL file, however, title, author, and copyright information 
set through SMIL may override the information you set here. 


For More Information: See “Where Title, Author, and Copyright 
Information Displays” on page 238. 
Creating a Background Color 


The optional background-color attribute sets an initial background color. The 
default color is black. RealPix backgrounds can use color names, which are 
listed in “Using Color Names” on page 553, or hexadecimal color values, 
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which are described in “Defining Hexadecimal Color Values” on page 554. 
RealPix does not support RGB colors in the format rgb(n,n,n), however. The 
following example sets the initial background color to a shade of red: 


<head background-color="#E00000”.../> 


Note: In RealPix, background-color is hyphenated. In SMIL 2.0, 
the backgroundColor attribute for regions uses camel case. 


Tip: During the course of a slideshow, you can change the 
background color with the <fill/> tag, which is described in the 
section “Painting a Color Fill” on page 173. 


Setting a Preroll Value 


The optional preroll attribute specifies the time to buffer data in RealOne 
Player before the start of the RealPix presentation. The following example sets 
the RealPix preroll to 40 seconds: 


<head preroll="40".../> 


Helix Universal Server always calculates the preroll required for the 
presentation based on the image file sizes and presentation timing 
parameters. If this calculated value is larger than the preroll you set, it 
overrides your specified preroll. Your preroll value is used, however, if it is 
higher than the calculated preroll value. You therefore need to set the preroll 
value only if you want an artificially high preroll. 


A high preroll can be useful when you stream RealPix with another clip. 
Suppose that a RealVideo clip starts midway through a RealPix presentation. 
You can use a high preroll to download a significant portion of the RealPix 
data before the presentation starts. The RealVideo clip then has more 
bandwidth available when it begins. It can therefore stream its required preroll 
without competing with RealPix for bandwidth. 


Tip: Always balance preroll values with viewer expectations. 
Viewers may not stay tuned to a presentation that takes a long 
time to start playing back. To determine the preroll for a clip 
streamed in parallel with your slideshow, such as an audio 
soundtrack, open the clip in RealOne Player, and use 
View>Clip>Clip Source to view the buffering information. 


For More Information: For more on preroll, see “Estimating the 
Required Bandwidth and Preroll” on page 154. 
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Adding a Presentation URL 


The optional url attribute sets a hyperlink URL for the presentation. When the 
viewer clicks a presentation image, the RealPix presentation continues to play 
as the URL opens in the RealOne Player media browser pane, or, with earlier 
versions of RealPlayer, in the viewer’s default Web browser. Individual effects 
can also include a url attribute that overrides the presentation-wide value for 
the duration of the effect. For the attribute value, use a fully qualified URL 
such as the following: 


<head url=“http://www.real.com”.../> 


For More Information: You can also use the url attribute to open 
a streaming presentation in a new RealOne Player media 
window. See “Opening a Media Playback Window with a Clip 
Link” on page 383. 


Handling Image Aspect Ratios 


With its default value of true, the aspect attribute keeps an image at its normal 
width-to-height ratio when the width and height attributes in the <head/> tag 
create a different width-to-height ratio for the playback area. In this case, 
images are displayed as large as possible in the playback area without cropping 
and distortion. The background color or the preceding image appears in the 
areas not covered by the new image. You can turn this off by setting the 
attribute to false: 


<head aspect="false”.../> 


In this case, RealOne Player fills the defined playback area with each image, 
which distorts any images that have width-to-height ratios different from the 
display area. Images are never cropped, however. The following figure shows 
how a source image fills a display area differently when aspect is set to false or 
true. 
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Effects of Overriding and Maintaining Image Aspect Ratios 


Source Image 


= 


Destination Images Destination Images 
aspect="false" aspect="true" 


Note: The aspect attribute in the <head/> tag affects the entire 
presentation, but individual effects can override this setting 
with their own aspect attributes, as described in “Changing an 
Image’s Aspect Ratio” on page 170. 


Setting the Maximum Frames Per Second 


The optional maxfps attribute specifies an integer from 1 to 30 that sets the 
maximum frames per second (fps) for RealPix transition effects: 


<head maxfps="5".../> 


This attribute is not required because RealOne Player determines the optimal 
frame rate based on the playback computer’s available CPU power. When CPU 
power is plentiful, RealOne Player renders transition effects at the maximum 
of 30 fps. It scales down the transition rates accordingly when less CPU power 
is available. 


You can set the maxfps attribute low to create special effects, though. For 
example, maxfps="5" keeps transitions constrained to no more than S fps. This 
causes visible jerks in transitions, which may be a desirable effect. Additionally, 
you can use maxfps in RealPix transition tags to balance CPU usage between 
multiple RealPix slideshows played simultaneously in a SMIL presentation. 
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For More Information: Individual effects can override the 
presentation value with their own maxfps values. See “Capping 
an Effect’s Frame Rate” on page 170. 


Defining Images 


For each image you use in the RealPix presentation, you add an <image/> tag 
after the <head/> tag. The <image/> tag provides the image file location, and 
assigns the image a unique handle number. The following table summarizes 
the <image/> tag attributes. An asterisk (*) denotes a required attribute. 


RealPix <image/> Tag Attributes 


Attribute Value Function Reference 
‘handle* integer | Setsan ID used by transition effects. ~~ page 165 
name* filename Provides the file name and path. page 166 
size bytes Indicates the file size for Web server delivery. page 166 
mime mime_type | Specifies a mime type for Web server delivery. | page 167 


Creating an Image Handle 


The required handle attribute assigns a positive integer to the image. Each 
handle number within the file must be unique. The RealPix effects tags refer 
to the handle number, rather than the file name, in their target attributes. 
Here is an example of an image handle: 


<image handle="18".../> 


that an effects tag refers to when fading in the image: 


<fadein target="18".../> 


Although it is not required, you may find that using sequential handle 
numbers, as well as listing <image/> tags according to the handle numbers, 
helps you to keep the organization of your presentation clear: 

<image handle="1".../> 

<image handle="2".../> 

<image handle="3".../> 


Note: It is not necessary to follow the handle order when 
defining the timeline. The image with handle="3” might appear 
first, followed by the image with handle="1". 
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Specifying an Image File Name and Path 


The required name attribute specifies the image file name, along with its path 
relative to the location of the RealPix file. The file name and path are case 
sensitive. When streaming files from Helix Universal Server, folder (directory) 
names must not contain spaces. The following example designates an image 
file that resides in the same folder as the RealPix file: 


<image name="tulip.jpg”.../> 
Image files can also reside in folder levels below (but not above or adjacent to) 


the RealPix file. This next example indicates that the image file resides one 
level below the RealPix file in the images folder: 


<image name="images/tulip.jpg”.../> 


Streaming the Presentation 


The local, relative paths for the name attribute allow you to develop and test 
your RealPix slideshow locally. You do not need to change the name values 
when you are ready to stream your slideshow. In a Ram or SMIL file, you 
simply use an HTTP or RTSP URL to request the RealPix file. The images 
automatically use the same protocol used to request the RealPix file. 


Keeping All Files on the Same Server 
Unlike a SMIL presentation, in which various clips can reside on different 
servers, RealPix requires that the RealPix file and all image files stay on the 
same server. This is because Helix Universal Server reads the RealPix file and 
determines the image file sizes to calculate how much preroll it must stream 
to RealOne Player before the slideshow can begin. 


Using Absolute, Local URLs 


If you are developing a presentation that plays back locally for all viewers 
(rather than streams from a server), you can use absolute, local URLs in the 
following format, which includes three forward slashes in file:///, and uses 
forward slashes in path names as well: 


file:///C:/My Documents/Images/picture1.jpg 


Indicating the Image Size for Web Servers 


The optional size attribute, which works only with RealPlayer 7 or later, 
specifies the size of the image in bytes. Include it in the <image/> tag when 
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delivering a RealPix presentation with a Web server. RealOne Player can then 
determine when to request each image file from the Web server to ensure 
smooth playback. Here is an example of an image file approximately 24 KB in 
size: 

<image size="24000".../> 

The size attribute is not required when streaming a RealPix presentation from 
Helix Universal Server, which determines image sizes directly through the 
files. It then calculates when to stream each image to ensure smooth playback 
for the viewer’s given bandwidth. 


Note: Be careful to list the file sizes correctly. If the file is 
significantly larger than the value given by its size attribute, 
the presentation may stall. 


Setting the Mime Type 


The optional mime attribute works with RealPlayer 7 and later. It specifies the 
image mime type, and may be necessary when delivering a RealPix 
presentation with a Web server. Here is an example: 


<image mime="image/jpeg”.../> 

The following are the valid mime types you can use: 

GIF images: mime=“image/gif” 

JPEG images: mime=“image/jpeg” 

PNG images: mime=“image/png” 

Helix Universal Server typically determines the MIME type from the image 


file’s extension, such as .gif or .jpg, making the mime attribute unnecessary. 
You need to include the mime attribute only on these two conditions: 


+ <image/> tags use the size attribute 
—and— 


+ the <image/> tag’s name attribute supplies a file name that does not 
include a file extension. 


Using Common Transition Effects Attributes 


Most RealPix transition effects tags, which are described in “Creating RealPix 
Transition Effects” on page 170, use a common set of attributes that select an 
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image, indicate when the effect occurs within the RealPix timeline, set the 
effect duration, and so on. The following table summarizes these attributes. 
The sections on each RealPix tag indicate which of these attributes an effect 
requires, or can optionally include. 


RealPix Common Effects Tag Attributes 


Attribute Value Function Reference 
aspect false|true | Maintains or ignores the image aspect ratio. page 170 
duration |time_value | Specifies the effect’s total duration. page 168 
maxfps integer Controls the maximum frame rate. page 170 
start time_value_ | Gives the effect start time. page 168 
target handle Indicates the image used for the effect. page 169 
url URL Sets a link URL while the effect is active. page 169 


Setting an Effect Start Time 


The start attribute is required for all RealPix effects. It specifies the time from 
the beginning of the RealPix timeline that the effect occurs. Here is an 
example that starts a crossfade at 12.3 seconds into the timeline: 


<crossfade start="12.3".../> 


The individual start times create the timeline for the individual effects, while 
the <head/> tag’s duration attribute sets the overall presentation time. If your 
last start time is 180, for example, make sure that the duration attribute set in 
the <head/> tag is greater than 180. For more on this, see “Setting the 
Presentation Duration” on page 160. 


Note: To specify start and duration values in seconds, you must 
set timeformat=“dd:hh:mmiss.xyz” in the <head/> tag. Otherwise, 
a value such as start="12” means 12 milliseconds. For more on 
the time format, see “Specifying the Time Format” on page 
159. 


Specifying an Effect Duration 


The duration attribute in an effect tag is unrelated to the duration attribute in 
the <head/> tag. In an effect tag, the duration attribute specifies the total time 
for the effect to complete. The higher the value, the slower the effect. For 
example, the following value causes the fade to complete in 2.5 seconds: 
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<fadein start="12” duration="2.5".../> 


The duration attribute affects only a transition effect, and does not control 
how long an image or color fill displays. The subsequent effect’s start attribute 
controls how long the image or color fill displays. Consider this example: 


<fadein target="5" start="12” duration="3".../> 
<fadein target="6”" start="18" duration="4".../> 


Here, image 5 starts to fade in at 12 seconds into the RealPix timeline. The 
fadein finishes at 15 seconds (12+3). The image then displays stationary for 
three seconds when, at 18 seconds into the timeline, image 6 begins to fade in. 
The second fadein completes at 22 seconds into the timeline (18+4). At that 
point, image 6 has completely replaced image 5S. 


Selecting the Image Target 


The target attribute is required for effects that introduce images. It specifies 
the <image/> tag handle of the image, which is described in “Creating an 
Image Handle” on page 165. For example, if tulips.jpg is defined with the 
following <image/> tag: 

<image handle="2” name="tulips.jpg” /> 

you fade tulips.jpg into the presentation by targeting the handle number: 


<fadein target="2".../> 


Creating an Effect URL 


The url attribute sets a hyperlink URL that is valid for as long as the image 
displays, overriding the URL set through the <head/> tag, which is described in 
“Adding a Presentation URL” on page 163. When the viewer clicks the image, 
the RealPix presentation continues to play as the URL opens in the RealOne 
Player media browser pane, or, with earlier versions of RealPlayer, in the 
viewer’s default Web browser. Use a fully qualified URL like the following: 


<fadein url=“http://www.real.com”.../> 
For More Information: Note that you can use the url attribute to 
open a streaming presentation in a new RealOne Player 


window. See “Opening a Media Playback Window with a Clip 
Link” on page 383 for more information. 
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Opening URLs Automatically 


The URLs specified by url attributes open only when clicked. However, when 
you stream a RealPix presentation to RealOne Player, you can use SMIL 2.0 to 
open HTML URLs automatically. You might open a different HTML page 
after each image displays, for example. To do this, create a SMIL 2.0 file that 
plays the RealPix presentation, and includes timed <area/> tags that open 
automatically through the actuate="onLoad” attribute. See “Linking to HTML 
Pages” on page 371 for more information. 


Tip: You'll need to take into account the bandwidth required to 
open HTML page URLs as you plan your RealPix slideshow. 
Otherwise, the slideshow may pause as each page opens. 


Changing an Image’s Aspect Ratio 


You can set the optional aspect attribute to true or false in an effect tag to 
override the aspect attribute set in the <head/> tag, which is described in 
“Handling Image Aspect Ratios” on page 163. The image introduced with the 
effect then appears undistorted (aspect="true”) or distorted (aspect="false”) if it 
has a different width-to-height ratio than the display area. Here is an example: 


<crossfade aspect="false”.../> 


Capping an Effect’s Frame Rate 


The optional maxfps attribute specifies an integer from 1 to 30 that sets the 
maximum frames per second for the effect. It overrides any default maxfps 
value set in the <head/> tag, which is described in “Setting the Maximum 
Frames Per Second” on page 164. Here’s an example: 


<fadein maxfps="5".../> 


Creating RealPix Transition Effects 
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The following sections describe the RealPix tags that you use to introduce 
images, display transition effects such as fades, and create special effects such 
as zooms. The section “Using Common Transition Effects Attributes” on page 
167 describes the standard attributes used in many of these effects tags. 


Fading In on an Image 
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The <fadein/> tag creates a gradual transition from the currently displayed 
color or image to another image. A <fadein/> tag looks like this: 


<fadein start="4" duration="3” target="2"/> 


The following figure illustrates a fade from a solid color to an image. 


Fade from a Solid Color to an Image 


The following table summarizes the attributes that you can use in a <fadein/> 
tag. An asterisk (*) denotes a required attribute. 


RealPix <fadein/> Tag Attributes 


Attribute Value Function Reference 
aspect false|true | Maintains or ignores the image aspect ratio. | page 170 
dsth|dstw| | pixels Sets the size and placement of the image that | page 179 
dstx|dsty fades in. 

duration* | time_value | Specifies the effect’s total duration. page 168 
maxfps integer Controls the maximum frame rate. page 170 
srch|srcw| | pixels Selects part of the source image for the effect. | page 179 
srcx|srcy 

start* time_value | Gives the effect start time. page 168 
target* handle Indicates the image used for the effect. page 169 
url URL Sets a link URL while the effect is active. page 169 


Tip: You can fade in multiple images simultaneously. 


RealNetworks recommends that these images do not overlap, 


however, because the appearance may be unpredictable. 
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Fading an Image Out to a Color 


The <fadeout/> tag defines a transition from an image to a color. You can use a 
predefined color name or a hexadecimal value, as described in Appendix C. 
RealPix does not support RGB colors in the format rgb(n,n,n), however. The 
following example fades the RealPix display area to yellow: 


<fadeout start="10" duration="3” color=“yellow“/> 


The following figure illustrates a fade to a solid color. 


Fade from an Image to a Solid Color 


The following table summarizes the attributes that you can use in a <fadeout/> 


tag. An asterisk (*) denotes a required attribute. 


RealPix <fadeout/> Tag Attributes 


Attribute Value Function Reference 
color name| Sets the fade color. page 553 
H#RRGGBB 

dsth|dstw| | pixels Sets the size and placement of the rectangle | page 179 
dstx|dsty that fades out. 

duration* | time_value | Specifies the effect’s total duration. page 168 
maxfps integer Controls the maximum frame rate. page 170 
start* time_value | Gives the effect start time. page 168 


Crossfading One Image Into Another 


The <crossfade/> tag creates a transition from one image to another, as 
illustrated in the following figure. An image should be displaying in the 
RealPix area already when you use a crossfade to specify a new image: 


<crossfade target="4” start=“15”" duration="4"/> 
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Crossfade from One Image to Another 


OR 


i DB 


The following table summarizes the attributes that you can use in a 


<crossfade/> tag. An asterisk (*) denotes a required attribute. 


RealPix <crossfade/> Tag Attributes 


Attribute Value Function Reference 
aspect false|true | Maintains or ignores the image aspect ratio. | page 170 
dsth|dstw| | pixels Sets the size and placement of the image that | page 179 
dstx|dsty fades in. 

duration* |time_value | Specifies the effect’s total duration. page 168 
maxfps integer Controls the maximum frame rate. page 170 
srch|srcw| | pixels Selects part of the source image for the effect. | page 179 
srcx|srcy 

start* time_value | Gives the effect start time. page 168 
target* handle Indicates the image used for the effect. page 169 
url URL Sets a link URL while the effect is active. page 169 


Painting a Color Fill 


The <fill/> tag paints a colored rectangle instantly. Use it anytime you want to 
fill all or part of the display area. You can fade in an image, for instance, then 


fill the display area with a color that paints over the image. You can use a 


predefined color name or a hexadecimal value, as described in Appendix C. 


RealPix does not support RGB colors in the format rgb(n,n,n), however. A 
<fill/> tag looks like this: 


<fill start="9" color="#23A134"/> 
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The following table summarizes the attributes that you can use in a <fill/> tag. 
An asterisk (*) denotes a required attribute. 


RealPix <fill/> Tag Attributes 


Attribute Value Function Reference 
color name| Sets the fill color. page 553 
H#RRGGBB 
dsth|dstw| | pixels Sets the size and placement of the rectangle | page 179 
dstx|dsty that is filled. 
start* time_value | Gives the effect start time. page 168 
Creating a Wipe Effect 


The <wipe/> tag creates a transition from one image to another, either by 
having the second image slide over and cover the first image, or by having it 
push the first image out of the display area. A typical <wipe/> tag looks like 
this: 

<wipe type=“push” direction="Left” start="10" duration="3" target="2"/> 


The following figure illustrates this effect. 


“Push” Wipe Transition from One Image to Another 


The following table summarizes the attributes that you can use in a <wipe/> 


tag. An asterisk (*) denotes a required attribute. 


RealPix <wipe/> Tag Attributes 


Attribute Value Function Reference 

aspect false|true Maintains or ignores the image aspect ratio. | page 170 

direction* |left|right| | Sets the wipe effect direction. page 175 
up|down 


(Table Page 1 of 2) 
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RealPix <wipe/> Tag Attributes (continued) 


Attribute Value Function Reference 
dsth|dstw| | pixels Sets the size and placement of the image that | page 179 
dstx|dsty is wiped in. 

duration* time_value | Specifies the effect’s total duration. page 168 
maxfps integer Controls the maximum frame rate. page 170 
srch|srcw| | pixels Selects part of the source image for the effect. | page 179 
srcx|srcy 

start* time_value | Gives the effect start time. page 168 
target* handle Indicates the image used for the effect. page 169 
type* normal|push | Specifies the type of wipe effect. page 175 
url URL Sets a link URL while the effect is active. page 169 


(Table Page 2 of 2) 


Setting the Wipe Type 
The required type attribute defines the type of transition that occurs: 


normal New image moves over current image, which remains stationary. 


ush New image pushes current image out (both images move). 
gep 8 g 


Here is an example: 


<wipe type=“push”.../> 
Choosing the Wipe Direction 


The required direction attribute sets the direction the new image moves: 


left New image starts at right edge, moves toward left edge. 
right New image starts at left edge, moves toward right edge. 
up New image starts at bottom edge, moves toward top edge. 


down New image starts at top edge, moves toward bottom edge. 


For example: 


<wipe direction=“up”.../> 


Controlling an Animated GIF Image 


When you display an animated GIF image in a RealPix slideshow, the GIF does 
not automatically begin to animate. Instead, you use the <animate/> tag to 
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start the GIF cycling through its frames. This lets you control when the 
animation starts, and how long it lasts. An <animate/> tag looks like this: 


<animate start="10" duration="30" target="2"/> 


The following table summarizes the attributes that you can use in a 
<animate/> tag. An asterisk (*) denotes a required attribute. 


RealPix <animate/> Tag Attributes 


Attribute Value Function Reference 
aspect false|true | Maintains or ignores the image aspect ratio. | page 170 
dsth|dstw| | pixels Sets the size and placement of a GIF page 179 
dstx|dsty introduced with <animate/>. 

duration* | time_value | Specifies the effect’s total duration. page 168 
maxfps integer Sets the animation’s maximum frame rate. page 170 
srch|srcw| | pixels Selects part of the source GIF to display. page 179 
srcx|srcy 

start* time_value_ | Gives the effect start time. page 168 
target* handle Indicates the image used for the effect. page 169 
url URL Sets a link URL while the effect is active. page 169 


If you introduce an animated GIF into the presentation with <animate/>, the 
GIF appears instantly at its start time, with no transition effect. However, you 
can also introduce the GIF with another tag, such as <fadein/>, then use 
<animate/> to start the animation. Here’s an example: 


<fadein start="5" duration="1" target="2"/> 
<animate start="10" duration="30" target="2"/> 


In this example, the animated GIF fades in at five seconds into the timeline. 
Its first frame remains stationary until 10 seconds into the timeline. The GIF 
then cycles through its programmed animation sequence for 30 seconds. 


Note: The RealPix <animate/> tag is not related to the 
<animate/> tag used in SMIL animations, which is described in 
“Animation Tags” on page 418. 


Zooming In, Zooming Out, and Panning 


The <viewchange/> tag defines a pan or a zoom. It requires the use of the 
source and destination attributes described in “Controlling Image Size and 
Placement” on page 179. A typical <viewchange/> tag looks like this: 
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<viewchange start="24" duration="3" srcx="80" srcy="80" srcw="48" srch="48"/> 


Note that <viewchange/> does not specify an image. The view change always 
affects the image currently in the display area. The following figure illustrates 
a zoom created with a <viewchange/> tag. 


Zoom Effect Created with a View Change 


The following table summarizes the attributes that you can use in a 


<viewchange/> tag. An asterisk (*) denotes a required attribute. 
g & q 


RealPix <viewchange/> Tag Attributes 


Attribute Value Function Reference 
dsth|dstw| | pixels Sets the size and placement of the destination | page 179 
dstx|dsty rectangle. 

duration* | time_value | Specifies the effect’s total duration. page 168 
maxfps integer Controls the maximum frame rate. page 170 
srch|srcw| | pixels Selects the size and placement of the source | page 179 
srcx|srcy rectangle. 

start* time_value | Gives the effect start time. page 168 


Zooming In on an Image 


To zoom in on an image, display the image and then use <viewchange/> to 
define a source rectangle to zoom in on. The following example is taken from 
a RealPix presentation that displays in an area 256-by-256 pixels. The source 
image is also 256-by-256 pixels. The presentation fades in on the image and 
then zooms in, taking three seconds to complete the zoom: 

<fadein start="1" duration=“2” target=“1"/> 

<viewchange start="4" duration="3" srcx="64" srcy="64" srcw="128" srch="128"/> 
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The zoom selects a source rectangle that is 128-by-128 pixels, and that appears 
in the center of the source image. This source rectangle displays in the full 
256-by-256-pixel display area. The following figure illustrates this zoom. 


Zooming in on Part of an Image 


Destination 
Source 


Because this zoom effect does not specify a destination rectangle, the zoom 
image fills the entire display area. But you can also use the destination 
coordinates (dstx, dsty, dstw, dsth) to specify a destination rectangle within the 
display area. 


Panning Across an Image 


To pan across an image, display a portion of the source image, then use 
<viewchange/> to move to a different part of the source image. The following 
example uses a RealPix presentation that displays in an area 256-by-256 pixels. 
The source image is also 256-by-256 pixels: 

<fadein start="1" duration="3" target="2"/> 

<viewchange start="4" duration="3” srcx="0" srcy="0" srcw="128" srch="128"/> 
<viewchange start="7" duration="3” srcx=“128" srcy="0" srcw=“128" srch="128"/> 


The presentation fades in an image, zooms in on the upper-left quadrant, then 
pans to the upper-right quadrant. Each effect takes three seconds to complete. 
The following figure illustrates this movement. 
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Zooming in on, then Panning across an Image 


128 


Because this pan effect does not specify a destination rectangle, the source 
rectangle fills the entire display area. But you can also use the destination 
coordinates (dstx, dsty, dstw, dsth) to specify a destination rectangle within the 
display area. 


Controlling Image Size and Placement 


When RealOne Player plays a RealPix slideshow, it expands its media playback 
pane to the size defined by the <head/> tag’s width and height attributes. To 
create a simple presentation such as a basic slideshow, you can simply fade the 
images in and out of this display area. Images the same size as the display area 
appear full-size. Larger images shrink to fit the area, smaller images expand. 
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You may want to display just a portion of a source image, however. Or you may 
want to display two images side-by-side. RealPix lets you specify a portion of a 
source image that appears in the display area. It also lets you determine the 
size and placement of images in the display area. To understand how this 
works, keep in mind the following definitions: 


Source Image 
An image used in your slideshow. A presentation may display one source 


image at a time, or it may display several source images arranged ina 
checkerboard pattern, for instance. 


Source Rectangle 
The portion of a source image you want to display. You might want to 


display only the top half of a source image in the display area, for example. 
Think of the source rectangle as a cropped version of a source image that 
you can display in a RealPix slideshow without altering the source image. 
Display Area 
The part of the RealOne Player media playback pane in which your 
presentation plays back. You set the display area size with the RealPix 
<head/> tag’s width and height attributes, as described in “Defining the 
Presentation Size” on page 159. 


Destination Rectangle 
A portion of the display area where the source rectangle appears, such as 


the area’s upper-left quadrant. Keep in mind that a destination rectangle 
does not have to have the same size or proportions as a source rectangle. 


Defining Source and Destination Attributes 


To use just a portion of a source image or the display area for an effect, you 
define the source rectangle, destination rectangle, or both in an effect tag. To 
do this, you work with the attributes described in the following table. 


Attributes for Defining Source and Destination Rectangles 


Attribute Specifies 


dsth Height of the destination rectangle in pixels. 

dstw Width of the destination rectangle in pixels. 

dstx Horizontal coordinate in pixels for the destination rectangle’s left corner. 
dsty Vertical coordinate in pixels for the destination rectangle’s left corner. 
srch Height of the source rectangle in pixels. 


(Table Page 1 of 2) 
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Attributes for Defining Source and Destination Rectangles (continued) 


Attribute Specifies 


Width of the source rectangle in pixels. 


STCXx Horizontal coordinate in pixels for the source rectangle’s left corner. 


srcy Vertical coordinate in pixels for the source rectangle’s left corner. 
(Table Page 2 of 2) 


The offset attributes (dstx, dsty, srcx, and srcy) default to zero. The destination 
rectangle size attributes (dstw and dsth) default to the display area width and 
height. The source rectangle size attributes (srcw and srch) default to the 
source image width and height. This means that if you leave the source 
attributes out of a tag, the entire source image is used. If you leave the 
destination attributes out of a tag, the selected image portion fills the entire 
display area. 


Note: The aspect attribute, described in “Handling Image 
Aspect Ratios” on page 163, determines how an image appears 
when the source and destination rectangles have different 
width-to-height ratios. 


Exhibiting Part of an Image in the Entire Display Area 


In the example below, both the source image and display area are 256 pixels 
high by 256 pixels wide. The source rectangle tags display the upper-left 
quadrant of the source image in the display area, effectively magnifying the 
source rectangle by a factor of 2. Because the destination rectangle defaults to 
the display area size, no destination rectangle coordinates are needed. 
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Part of the Source Image Filling All of the Display Area 


Destination 


Source 


256 ———»! 


srcx="0" srcy="0" srch="128" srcw="128" 


To introduce this image with a fade, for example, you add the source 
attributes to the <fadein/> tag: 


<fadein start="4" duration="3” target="2" srx="0" srcy="0" srch="128" srcw="128"/> 


Showing All of an Image in Part of the Display Area 


In the next example, the source image displays in the upper-right quadrant of 
the display area, effectively reducing the size of the source image by half. No 
source coordinates are included, so the entire source image displays in the 
destination rectangle. 
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All of the Source Image Filling Part of the Display Area 
Destination 


Source 


256 ———____»! 


dstx="128" dsty="0" dsth="128" dstw="128" 


To paint the background, then wipe this image into the display area, for 
instance, you use a <fill/> tag followed by a <wipe/> tag that includes the 


destination attributes: 


<fill color="#E7651A” start="9"/> 
<wipe type=“push” direction=“down” start="10" duration="3" target="2” 


dstx="128”" dsty="0" dsth="128” dstw="128" /> 


Filling Part of the Display Area with Part of the Source Image 


This example shows a portion of the source image displayed at a slightly larger 
size in the display area. In this case, both source and destination coordinates 
are needed to define the source and destination rectangles. 
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Part of the Source Image Filling a Part of the Display Area 


Source Destination 


= 


PA Sa 


Be 


eck 


srcx="0" srcy="0" srch="128" srcw="128" 
dstx="64" dsty="32" dsth="192" dstw="192" 


256 —————>: 


To introduce this image with a fade, for example, you add the source and 
destination attributes to the <fadein/> tag: 


<fadein start=“1" duration="2” target="5" srx="0" srcy="0" srch="128" srcw="128" 
dstx="64” dsty="32” dsth="192” dstw="192”/> 


RealPix Example 
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This section takes you through the process of creating a RealPix presentation 
step-by-step. Be sure to read “Managing RealPix Bandwidth” on page 154 
before you work through this example. To get playable RealPix sample files, 
download the zipped HTML version of this guide as described in “How to 
Download This Guide to Your Computer” on page 12, and view the Sample 
Files page. 


Step 1: Determine the Bandwidth Use 


Suppose that you want to create a RealPix slideshow that contains five images. 
You want to coordinate the images to a RealAudio background music clip that 
lasts 3 minutes. You want the slideshow and audio to end after 1-1/2 minutes, 
though, and to be available to viewers who have 56 Kbps dial-up modems. 
According to the table “Maximum Streaming Rates” on page 47, you have 34 
Kbps of available bandwidth that you can split between RealAudio and 
RealPix. 
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Choose the RealAudio Streaming Rate 


The first step is to determine your RealAudio bandwidth. When you encode a 
RealAudio clip with Helix Producer, you can set an option that lowers the 
RealAudio bandwidth for the 56 Kbps modem target audience from 32 Kbps 
to 20 Kbps. (If you have Helix Producer Plus, you can change this to any 
available rate.) At the 20 Kbps RealAudio rate, the RealPix slideshow has 14 
Kbps of bandwidth available (34-20=14). 


If you plan to stream with Helix Universal Server, use SureStream RealAudio, 
and select one or more target audiences at higher bit rates. This enables 
viewers with faster connections to get better audio quality. When using a Web 
server, though, you cannot use SureStream. 


Note: You can determine an audio clip’s streaming bit rate and 
initial buffering time (preroll) by opening the clip in RealOne 
Player, and giving the View>Clip>Clip Source command. 


For More Information: See your Helix Producer user’s guide or 
online help for instructions on modifying RealAudio’s 
streaming bit rate for a given target audience. 


Determine the Image Bandwidth Requirements 


Once you know your target bit rate for your RealPix images, add up the image 
sizes to get a rough idea of whether your planned timeline is viable. Suppose 
the following are the images you want to use: 


frog.jpg 24 Kilobytes 
tiger.jpg 39 Kilobytes 
cows.jpg 55 Kilobytes 


elephant.jpg 38 Kilobytes 
hippo.jpg 38 Kilobytes 


The desired timeline is 90 seconds, with the presentation streaming at 14 
Kbps. This means the slideshow can stream 1260 Kilobits (90 x 14) of image 
data, which equals 157.5 Kilobytes (1250/8). The images add up to 194 
Kilobytes, which will make the preroll fairly long. To lower the preroll, you can 
either extend the timeline, or reduce the image file sizes. Suppose that 
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through cropping, resizing, and higher JPEG compression, you modify the 
images to these sizes: 


frog.jpg 20 Kilobytes 11.4 seconds to stream 
tiger.jpg 35 Kilobytes 20 seconds to stream 
cows.jpg 45 Kilobytes 25.7 seconds to stream 


elephant.jpg 31 Kilobytes 17.7 seconds to stream 
hippo.jpg 31 Kilobytes 17.7 seconds to stream 


The images now total 162 Kilobytes, which is acceptable because it is only 
slightly over the 157.5 Kilobyte target. To better plan the timeline, it helps to 
determine how long each image takes to stream, as shown in the table above. 
To get these numbers, multiply each file size in Kilobytes by 8 to get Kilobits, 
then divide by your target bit rate (14 Kbps in this example). 


Step 2: Write the RealPix File 


Once you have settled your bandwidth issues, you can write your RealPix file. 
If you know how long it takes each image to stream, you can better adjust the 
RealPix timeline to keep the preroll as low as possible. It helps to stream the 
smaller images first, and to space each image out so that it doesn’t appear too 
soon after the preceding image. The following timeline streams images in 
order from smallest to largest: 


start="0" frog.jpg 20 Kilobytes 11.4 seconds to stream 
start="20"  elephant.jpg 31 Kilobytes 17.7 seconds to stream 
start="40"  hippo.jpg 31 Kilobytes 17.7 seconds to stream 
start="60" _tiger.jpg 35 Kilobytes 20 seconds to stream 

start="80" cows.jpg 45 Kilobytes 25.7 seconds to stream 


Because the first image (frog.jpg) is scheduled to appear as soon as the 
presentation starts, the timing will obviously cause at least an 11.4-second 
preroll while the first image streams to RealOne Player. But, as you'll see 
below, you can mask this delay by starting the soundtrack before the images 
appear. 


Tip: Keep in mind that the individual streaming times are only 
a guide to developing the timeline. If an image has a 20-second 
streaming time, it can still display 15 seconds after another 
image. Helix Universal Server will always stream all of the 
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image data to RealOne Player before the image is scheduled to 
display, lengthening the presentation preroll if necessary. 


The RealPix markup might look like the following, which creates a 300-pixel- 
by-300-pixel display area, set a streaming bit rate of 14 Kbps, indicates a 90- 
second duration, and introduces each image with a four-second fade. The size 
parameters in the <image/> tags are not required when streaming with Helix 
Universal Server, but are included anyway to make Web server delivery 


possible. 


<imfl> 
<head title="My RealPix Slideshow" 
author="Jane Morales" 
copyright="(c)2002 RealNetworks Media Productions" 
background-color="black" 
timeformat="dd:hh:mmi:ss.xyz" 
duration="90" 
bitrate="14336" 
width="300" 
height="300" 
url="http://www.real.com" 
aspect="true"/> 


<image handle="1" name="frog.jpg' size="20480” /> 
<image handle="2" name="elephant.jpg" size="31744"/> 
<image handle="3" name="hippo.jpg" size="31744"/> 
<image handle="4" name="tiger.jpg" size="35840"/> 
<image handle="5" name="cows.jpg" size="46080" /> 


<fadein start="0" duration="4" target="1"/> 

<fadein start="20" duration="4" target="2"/> 
<fadein start="40" duration="4" target="3"/> 
<fadein start="60" duration="4" target="4"/> 
<fadein start="80" duration="4" target="5"/> 


</imfl> 


Step 3: Write the SMIL File 


To combine the RealPix slideshow with the RealAudio soundtrack, you write a 
SMIL file that defines the overall presentation. Because RealPix is backwards- 
compatible with earlier versions of RealPlayer, use SMIL 1.0 as long as you do 
not need the enhanced features of SMIL 2.0. This ensures the widest possible 
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audience. The following sample SMIL 1.0 file combines the RealPix slideshow 
(slideshow.rp) with the RealAudio clip (soundtrack.rm): 
<smil> 
<head> 
<meta name="title" content="My RealPix Slideshow" /> 
<meta name="author" content="Jane Morales"/> 
<meta name="copyright" content="(c)2002 RealNetworks Media Productions"/> 
</head> 
<body> 
<par endsync="id(pix)”> 
<audio src="rtsp://helixserver.company.com/soundtrack.rm”/> 
<ref src="rtsp://helixserver.company.com/slideshow.rp” id="pix” begin="15s"/> 
</par> 
</body> 
</smil> 


In this SMIL file, the endsync attribute in the <par> tag ends the presentation 
when the RealPix slideshow ends, cutting off the RealAudio soundtrack. The 
begin="15s" attribute in the slideshow’s <ref/> source tag delays the RealPix 
presentation from starting until 15 seconds after the soundtrack begins to 
play. Helix Universal Server uses that time to stream the RealPix slideshow’s 
preroll. This helps the entire presentation start to play back faster. 


Tip: It’s important always to test your presentation in an actual 
streaming environment. This may lead you to modify your 
timing parameters to make the presentation more efficient. 


For More Information: For information about SMIL 1.0, see 
RealSystem iQ Production Guide for Release 8, which is available 
at http://service.real.com/help/library/encoders.html. 
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The heart of streaming media, SMIL is powerful, but easy to 
learn. Start with Chapter 8, which covers the uses and structure 
of a SMIL file, to begin mastering the basics of SMIL. Chapter 9 


explains how to incorporate your clips into a presentation, 


delving into various network protocols such as RTSP and HTTP. 
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SMIL BASICS 


When your streaming presentation contains multiple clips—such as 
a video and streaming text played together—you use Synchronized 
Multimedia Integration Language (SMIL) to coordinate the parts. 
Pronounced “smile,” SMIL is a simple but powerful markup 
language for specifying how and when clips play. This chapter 


introduces you to SMIL, its advantages, and its syntax rules. 


Tip: For a streamlined introduction to basic SMIL features, 
download Introduction to Streaming Media from 
http://service.real.com/help/library/encoders.html. 


For More Information: Once you are familiar with SMIL, you can 
refer to “Appendix D: SMIL Tag Summary” beginning on page 
559 when you write your SMIL files. 


Understanding SMIL 


Recommended by the World Wide Web Consortium (W3C), SMIL is designed 
to be the standard markup language for timing and controlling streaming 
media clips. SMIL works for a media player similar to the way that HTML 
works for a Web browser. And just as HTML markup displays in any browser, 
the standardized SMIL language fosters interoperability between media 
players. You can find the official SMIL 2.0 specification at the W3C Web site: 


http://www.w3.org/TR/smil20/ 


For More Information: To learn more about multiplayer 
support, read “Interoperability Between SMIL-Based Players” 
on page 196. 
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Advantages of Using SMIL 


SMIL enables you to create complex media presentations without using 
scripting languages such as Javascript. Because scripting is not required, you 
do not have to embed SMIL presentations in a Web page. Additionally, SMIL 
presentations can play in RealOne Players that reside on consumer devices 
that do not include browsers. The following points explain a few of the major 
advantages of using SMIL: 


+ Stream clips located on different servers. 


Because a SMIL file lists a separate URL for each clip, you can put together 
presentations using clips stored on any server. You can use a video clip on 
a Helix Universal Server, for example, and an image clip on a Web server. 
Using SMIL eliminates the need to merge multiple clips into a single 
streaming file. 


Lay outa presentation. 


When your presentation includes multiple clips, such as a RealVideo clip 
playing simultaneously with subtitles written in RealText, you use SMIL 
to arrange the various clips. 


Time and control a presentation. 


SMIL provides powerful timing features that let you easily manage your 
presentation’s timeline. You can keep clips rigidly synchronized, for 
example, or start an audio clip playing at 2.5 seconds into its internal 
timeline without changing the encoded clip. 


Layer transparent clips. 


Using RealNetworks’ extensions to SMIL, you can easily add transparency 
to clips, and stack them on top of each other. You can turn an opaque 
graphic into a semi-transparent logo that hovers over a video, for example. 


Create interactive multimedia experiences. 


Using SMIL’s advanced features, you can easily create interactive media 
presentations, such as an audio or video jukebox that plays a different clip 
each time the viewer clicks a button. 


Link to Web pages. 


SMIL’s extensive hyperlinking capabilities allow you to link a streaming 
presentation to other streaming clips, or to Web pages. Web pages can 
display automatically at any time during the presentation, or may load 
only when the viewer clicks a link. 
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- Stream different presentations to different audiences. 


SMIL lets you stream different clips to different audiences based on 
criteria such as language preference or available bandwidth. This lets you 
create multiple presentations, but still have just one link on your Web 
page. When a viewer clicks that link, the viewer’s RealOne Player reads the 
options in the SMIL file and chooses the appropriate presentation. 


Note: SureStream also lets you support multiple bandwidth 
connections within a single clip. For more information, see 
“SureStream RealAudio and RealVideo” on page 50. 


Display special effects. 


Using SMIL’s transition effects and animations, you can create special 
effects, such as fading one clip into another, or moving a clip around the 
screen. This lets you duplicate special effects found in advanced video 
editing programs without making any changes to your streaming clips. 


Assemble customized presentations. 


Because a SMIL file is a simple text file, you can generate it automatically 
for each visitor. You can therefore create different presentation parts, 
assembling a customized SMIL file for each visitor. 


Include ads in presentations. 


You can use SMIL along with Helix Universal Server’s advertising 
extension to insert ads into your presentation. Helix Universal Server can 
deliver image banner ads, as well as media ads in formats such as 
RealVideo and Flash. 


SMIL 1.0 and SMIL 2.0 


SMIL 1.0 debuted in 1998. SMIL 2.0, introduced in 2001, updates and expands 
the SMIL 1.0 capabilities. RealOne Player can play SMIL 1.0 files and SMIL 2.0 
files. RealPlayer G2, RealPlayer 7, and RealPlayer 8 can play only SMIL 1.0 files, 
though. If these older RealPlayers encounter a SMIL 2.0 file, they autoupdate 
to RealOne Player before displaying the presentation. However, as described in 
“Combining SMIL 2.0 with SMIL 1.0” on page 454, you can add SMIL 2.0 
features to a SMIL 1.0 file that still plays in RealPlayer 7 or 8. 


Note: This guide describes SMIL 2.0 only. For information on 
SMIL 1.0, see RealSystem iQ Production Guide for Release 8. 
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SMIL 2.0 Modules 


SMIL defines a number of functional areas, such as timing and hyperlinking. 
Each functional area breaks down into one or more modules. In turn, each 


module defines certain attributes and values. The following table lists all the 


SMIL 2.0 modules, and indicates whether RealOne Player supports them. You 


may find this information useful if you are familiar with the SMIL 2.0 


specification. You do not need to know this information to create a SMIL 2.0 


presentation that plays in RealOne Player, however. 


SMIL 2.0 Supported Modules 


Functional Area Module Supported? Reference 
AccessKeyTiming yes page 349 
BasicInlineTiming yes page 314 
BasicTimeContainers yes page 247 
EventTiming yes page 338 
ExclTimeContainers yes page 259 
FillDefault yes page 334 
MediaMarkerTiming yes page 352 
MinMaxTiming yes page 320 
MultiArcTiming yes page 342 

Timing RepeatTiming yes page 323 
RepeatValueTiming yes page 344 
RestartDefault yes page 352 
RestartTiming yes page 352 
SyncbaseTiming yes page 342 
SyncBehavior yes page 250 
SyncBehaviorDefault yes page 255 
SyncMaster no n/a 
TimeContainerAttributes | yes page 327 
WallclockTiming yes page 352 

Time TimeManipulations yes (animations only) page 437 

Manipulations 

Pre BasicAnimation yes page 417 
SplineAnimation no n/a 
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SMIL 2.0 Supported Modules (continued) 


Functional Area Module Supported? Reference 
BasicContentControl yes page 439 
Gee cs CustomTestAttributes no n/a 
PrefetchControl yes page 467 
SkipContentControl yes tbd 
AudioLayout yes page 292 
BasicLayout yes page 267 
Layout ; 3 
HierarchicalLayout yes page 295 
MultiWindowLayout yes page 277 
BasicLinking yes page 357 
Linking LinkingAttributes yes page 367 
ObjectLinking no n/a 
BasicMedia yes page 209 
BrushMedia yes page 213 
MediaAccessibility yes page 241 
Media Objects MediaClipping yes page 316 
MediaClipMarkers yes page 352 
MediaDescription yes page 238 
MediaParam yes page 210 
Metainformation | Metainformation yes tbd 
Structure Structure yes page 198 
BasicTransitions yes page 391 
Transitions InlineTransitions no n/a 
TransitionModifiers yes page 406 
(Table Page 2 of 2) 


SMIL 2.0 Profiles 


SMIL also defines profiles, which are collections of modules that an application 
can support. RealOne Player supports the SMIL 2.0 Language Profile, which 
incorporates most of the SMIL modules listed in the preceding section. The 
other main profile is the SMIL 2.0 Basic Profile, which is designed primarily 
for smaller devices, such as mobile phones and portable disc players. The basic 


profile requires support for only the following modules: 
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+ BasicContentControl 
+ BasicInlineTiming 

+ BasicLayout 

+ BasicLinking 

+ BasicMedia 

+ BasicTimeContainers 
+ MinMaxTiming 

+ RepeatTiming 


- SkipContentControl 


Interoperability Between SMIL-Based Players 


Because SMIL is an standard markup language, any media player can adopt 
SMIL as its means for coordinating media clips. Although this allows 
interoperability between SMIL-based media players, it does not automatically 
mean that every presentation created for RealOne Player can play in other 
SMIL-based media players, and vice versa. The following sections explain 
differences in SMIL presentations that may prevent them from playing in all 
SMIL-based players. 


SMIL Version 


SMIL 1.0 and SMIL 2.0 differ significantly. Although most media players that 
support SMIL 2.0 (including RealOne Player) can also play SMIL 1.0 files, 
media players that support only SMIL 1.0 (including RealPlayer G2, RealPlayer 
7, and RealPlayer 8) cannot play SMIL 2.0 content. Be sure you know whether 
your target media players support SMIL 1.0, SMIL 2.0, or both. 


SMIL Profile 


As described in “SMIL 2.0 Profiles” on page 195, a SMIL-based media player 
can support different SMIL profiles. A media player that supports only the 
smaller module set of the SMIL 2.0 Basic Profile will not handle all of the 
attributes defined in the more robust SMIL 2.0 Language Profile. Hence, a 
presentation developed for RealOne Player may not play to its full capacity in 
a player based on the SMIL 2.0 Basic Profile. That player should just ignore 
the SMIL attributes it does not support, however. 
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Clip Support 
SMIL binds different types of clips together, and each SMIL-based media 
player must also be able to play the presentation’s clips, regardless of the 
player’s support for SMIL. For example, RealAudio and RealVideo clips are 
proprietary formats that play only in RealPlayer or RealOne Player, whereas 
QuickTime clips play only in the QuickTime Player. For interoperability, you 
must stream clips that all of your various target media players can play. 


Tip: You can tell ifa media player supports a certain type of 
clip by opening the clip in the player. If the clip plays, you can 
stream that type of clip to that player. 


Media Player Launch Methods 


Viewers typically launch streaming media presentations through a Web page 
hyperlink configured to start a specific player. For example, Web pages that 
launch RealOne Player link to a Ram file (extension .ram), rather than to a 
SMIL file. If you link directly to the SMIL file, the application registered with 
the browser to handle the file extension .smil launches and attempts to play 
the presentation. This is not recommended, however, because the launched 
application may not be one of your target media players. 


Tip: RealNetworks recommends that, even with a single SMIL 
file that plays in multiple media players, you create a separate 

Web page hyperlink to launch each of your target players. Your 
viewers can then decide which player they want to use. 


For More Information: For more starting RealOne Player with a 
Web page hyperlink, refer to “Launching RealOne Player with a 
Ram File” on page 507. 


Creating a SMIL File 


This section explains the basics of SMIL markup, introducing you to the rules 
you need to follow when creating a SMIL presentation. If you are familiar with 
other Web-based markup languages, such as HTML, you will pick up SMIL 
quickly. You need to be careful, though, because SMIL is less forgiving than 
HTML. Lapses that may not matter in HTML markup, such as missing 
quotation marks, missing slashes, or missing end tags, will prevent a SMIL file 
from working properly. 
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Tip: You can write a SMIL file with any text editor that can save 
the file as plain text. Save the file with the file extension .smil. 
Do not include spaces in the file name. 


Note: With many Web servers, you can use GZIP encoding for 
large SMIL files. For more information, see “GZIP Encoding 
for Large Text Files” on page 523. 


The SMIL 2.0 Tag and Namespace 


Rule 1: To create SMIL 2.0 files as described in this guide, the <smil> tag must 
include the XML namespace for SMIL 2.0. 
A SMIL file starts with a <smil> tag and ends with a</smil> tag. If the opening 
tag is just <smil>, the file is SMIL 1.0: 
<smil> 

..-SMIL 1.0 markup... 
</smil> 


To create a SMIL 2.0 file and use all the SMIL features described in this guide, 
the <smil> tag must look like the following: 
<smil xmlns=“http://www.w3.org/2001/SMIL20/Language”> 


... SMIL 2.0 markup... 
</smil> 


SMIL is based on Extensible Markup Language (XML), which provides the 
means for defining any number of standard or customized markup languages. 
The xmlns attribute shown above defines an XML namespace. This namespace 
has just one purpose: to tell RealOne Player that the file is SMIL 2.0 rather 
than SMIL 1.0. The namespace identifier is in the form of a URL only to 
ensure uniqueness. RealOne Player does not contact the URL. 


Header and Body Sections 


Rule 2: A SMIL body section is required, but the header section is optional. 


Between the <smil> and </smil> tags, a SMIL file breaks down into two basic 
subsections: the header and the body. The header is defined between <head> 
and </head> tags, while the body section falls within <body> and </body> tags, 
as shown here: 
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<smil xmlns=“http://www.w3.org/2001/SMIL20/Language”> 
<head> 
...optional section with all header markup... 
</head> 
<body> 
...required section with all body markup... 
</body> 
</smil> 


The optional header section is used to give presentation information, to create 
the layout, and to define features that are used repeatedly. To include a fade- 
to-black transition effect in your presentation, for example, you first define 
the transition type in the header. You can think of the header as defining your 
presentation’s form. 


The header section is optional because it’s not needed for very simple SMIL 
files. The following SMIL presentation, for example, simply plays three audio 
clips in sequence. Although the presentation could have a header section that 
provides presentation information, it doesn’t need a layout or any other 
features that must be defined in the header: 
<smil xmlns=“http://www.w3.org/2001/SMIL20/Language”> 
<body> 
<audio src="rtsp://helixserver.example.com/one.rm” /> 
<audio src="rtsp://helixserver.example.com/two.rm” /> 
<audio src="rtsp://helixserver.example.com/three.rm”/> 
</body> 
</smil> 


Within the required body section, you list the clips that you want to play, 
creating your presentation timeline in the process. Within the body section, 
you apply the features you defined in the header. For instance, you apply a 
fade-to-black transition defined in the header to clips listed in the body. You 
can think of the body as defining your presentation’s content and timeline. 


The header and body may each have their own subsections. The header may 
have a layout section defined between <layout> and </layout> tags, for example, 
while the body section uses <par> and </par> tags to define clips that play 
together. Other chapters in this guide describe the tags that you can use 
within the header and body sections. 


199 


RealNetworks Production Guide 


200 


Tags, Attributes, and Values 


Both the header and body of a SMIL file contain tags that have the following 
form: 


<tag attribute="value”" /> 


Aside from the angle brackets and a possible closing slash, there are three 
basic parts to a SMIL tag: 


tag The tag name comes just after a left angle bracket. Some tags may 
consist of just the name, as in the <body> tag. Other tags may have 
attributes. 


attribute Each attribute defines one aspect of the tag. If a tag has several 
attributes, the order of attributes doesn’t matter. 


“value” Most SMIL attributes include an equals sign (=) followed by a value in 
double quotation marks. In some cases, you choose from a list of 
predefined values. In other cases, you define your own value. Values may 
be integers, percentages, names, and so on, depending on what types of 
values are appropriate for the attribute. 


Rule 3: Lowercase or camel case text is required for most tags and attributes. 


SMIL tags and attributes must be lowercase. When an attribute or predefined 
value consists of a compound word, the first letter of all words after the first 
word is generally capitalized, as in soundLevel or whenNotActive. This is referred 
to as “camel case.” 


A few attributes, such as root-layout, are hyphenated. These attributes carry 
over from SMIL 1.0. They have been kept the same for consistency. Some new 
SMIL 2.0 attributes, such as accesskey, are meant to be compatible with HTML 
4.0 and, in accordance with the HTML 4.0 specification, do not capitalize 
letters in compound words. 


Rule 4: Attribute values must be enclosed in double quotation marks. 


Attribute values, such as video_region in region=“video_region”, must be 
enclosed in double quotation marks. Do not add any blank spaces between the 
quotation marks and the value they enclose. 


Rule 5: File names and paths must observe letter cases. 


In clip source tags, paths and file names can be uppercase, lowercase, or mixed 
case. All of the following path and file name examples are allowable, for 
example: 
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<audio src="rtsp://helixserver.example.com/song.rm”/> 
<audio src="rtsp://helixserver.Example.com/Song.rm”/> 
<audio src="rtsp://helixserver.example.com/SONG.rm”/> 


However, the path and file name in the tag should match the clip’s path and 
file name exactly as it appears on the server computer’s operating system. For 
instance, the following clip source tag may not work if the clip is actually 
named SONG.rm: 


<audio src="rtsp://helixserver.example.com/song.rm”/> 


Binary and Unary Tags 


Rule 6: All tags must have an end tag or close with a forward slash. 


Some SMIL tags, called binary tags, have a corresponding end tag. For 
example, the <body> tag has the end tag </body>. When a tag has no 
corresponding end tag, it is called a unary tag, and it must close with a forward 
slash as shown in this example: 


<audio src="first.rm”/> 


Warning! Omitting a closing slash where it’s needed, or adding 
it where it’s not required is one of the easiest ways to create an 
error in a SMIL file. Take care always to include a closing slash 
with a unary tag, and to leave it out of the first tag in a binary 
pair. 


Changing a Unary Tag to a Binary Tag 
Several SMIL tags can be either binary or unary, depending on how they 
operate. For example, a unary <video/> tag plays a video clip: 
<video ...specifies a video to play, and closes with a forward slash... /> 
However, you can also include a hyperlink with <video/> tag to link the clip to 


another clip or a Web page. To do this, you change the <video/> tag from unary 
to binary so that it can enclose an <area/> tag, as shown here: 


<video ...specifies a video to play, and uses an end tag... > 
<area ...defines an image map, and closes with a forward slash... /> 
</video> 


This guide tells you which tags can be both unary and binary, and explains the 
circumstances under which you use the unary or binary version. 
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SMIL Recommendations 


Although not strict rules, the following recommendations will help you keep 
your SMIL markup organized and understandable. 


Recommendation 1: Use HTML-style comments to annotate your SMIL file. 


As in HTML, SMIL has a comment tag that starts with these characters: 


<!-- 


and ends with these characters: 


--> 


The ending does not include a forward slash: 


<!-- This is a comment --> 


A comment can be any number of lines long. It can start and end anywhere in 
a SMIL file. Multiple comments cannot be nested, though. Use comments to 
describe what various sections of your SMIL presentation are meant to do. 
This helps other people understand your presentation more easily. 


Recommendation 2: Use indentation to clarify how your SMIL file is organized. 


Although indenting SMIL markup is not required, it helps you to keep track 
of the SMIL file’s structure. You typically indent markup by pressing the Tab 
key once for each level of indentation. In a clip group, for example, the group 
tags are indented one level from the body tags, and the clip tags are indented 
one level from the group tags, as shown here: 
<body> 
<seq> 
<audio src="rtsp://helixserver.example.com/one.rm” /> 
<audio src="rtsp://helixserver.example.com/two.rm”/> 
</seq> 
</body> 


SMIL Tag ID Values 


Any SMIL tag can have an ID in the form id=“value”. Some SMIL tags require 
IDs. For example, each region in the layout requires an ID that you use to 
assign clips to play in the region. For other tags, IDs are optional depending 
on whether another SMIL element interacts with that tag. The following are 
rules and suggestions that apply to the IDs of all SMIL tags: 


- All IDs for all tags in a SMIL file must be unique. If you define several 
<region/> tags, for example, each tag must have a unique ID. No <region/> 
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tag can have the same ID as a <transition/> tag or a <video/> tag, for 
instance. 


As with all SMIL values, IDs are case-sensitive. The attributes 
id=“videoregion” and id="“videoRegion” are different, for example. It is a 
good idea to follow a consistent practice, such as always making IDs 
lowercase. 


Do not use words separated by spaces in an ID. If you use two or more 
words for an ID, combine the words, or separate the words with an 
underscore or hyphen, as in videoregion, video-region, or video_region. 


The first character for an ID can be a letter, a colon, or an underscore. It 


cannot be a number or a special character such as an ampersand. You can 
use numbers and special characters after the first character, however. For 
example, you can use id=“video3” as an ID, but not id="3video”. 


There is no minimum or maximum length for IDs. 


You may find it convenient to adopt a system for specifying IDs. You 
might use the suffix _region for all region IDs, for example, or a transition_ 
prefix for all transition effect IDs. 


Using Customized SMIL Attributes 


SMIL can be customized, and RealNetworks has developed many extensions 
to SMIL 2.0 functionality. SMIL regulates how customizations can be added, 
though, to avoid potential conflicts between different media players. A 
customized attribute always has a prefix, and takes the following form: 


prefix:attribute="value” 


The prefix is user-defined, but the attribute name is always predefined. The 
following is an example of RealNetworks’ backgroundOpacity attribute, using a 
prefix of rn: 


rm:backgroundOpacity="50%”" 


When RealOne Player encounters this tag, it recognizes that backgroundOpacity 
is a valid attribute, but not a standard SMIL attribute. It uses the rn prefix to 

match the attribute to a namespace declared in the <smil> tag. The namespace 
must therefore use the same user-defined prefix as the attribute. You can add 
the additional namespace to the <smil> tag after the SMIL 2.0 namespace: 


<smil xmlns=“http://www.w3.org/2001/SMIL20/Language” 
xmlns:rn=“http://features.real.com/2001/SMIL20/Extensions”> 
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If RealOne Player recognizes the namespace, it knows how to handle the 
customized attribute. This allows RealOne Player to support any number of 
customized attributes developed by RealNetworks or other parties. 


RealNetworks Extensions Namespace 


RealNetworks has created many customized attributes that you can use in 
SMIL 2.0 files played in RealOne Player. To use these attributes, you must 
declare the following namespace in the <smil> tag: 


xmlns:rn=“http://features.real.com/2001/SMIL20/Extensions” 
This guide always uses rn: as the attribute prefix for RealNetworks extensions. 


If you decide to use a different prefix, it’s best to use a short, single word, or 
just a few letters. 


System Component Namespace 


The system component namespace allows you to mark elements that should 
play only in RealOne Player. This lets you add SMIL 2.0 elements to a SMIL 1.0 
presentation that can still play in RealPlayer 7 or 8. Unlike SMIL 2.0 
namespaces, this namespace requires the use of the cv prefix: 


xmlns:cv=“http://features.real.com/systemComponent” 


For More Information: See “Combining SMIL 2.0 with SMIL 1.0” 
on page 454 for an explanation of how to use this namespace. 


A Closer Look at Namespaces 


Namespaces and prefixes for customized attributes are not hard to declare and 
use, but they can be confusing at first if you are not familiar with XML. The 
following sections delve more deeply into namespaces and their associated 
prefixes for those who want a better understanding of this issue. When in 
doubt, though, just follow the examples in this guide, using the given prefixes 
when defining a namespace and a custom attribute. 


Why does SMIL use namespaces? 


Each customized attribute is defined in conjunction with a unique namespace 
so that SMIL-based media players can use different attributes that happen to 
have the same name. An attribute named find might perform one function 
when defined with one namespace, and a different function when defined 
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with another namespace. This allows different parties to create customized 
SMIL attributes without being concerned about duplicate attribute names. 


Why are prefixes used? 


A prefix ties an attribute to a namespace. Consider the example of two 
different find attributes in the same SMIL file. When RealOne Player has to 
interpret what a particular find attribute does, it matches the attribute to its 
namespace through the prefix. If there were no prefix, RealOne Player would 
not know which namespace goes with which attribute. 


Why are prefixes user-definable? 


If the parties who developed custom attributes also defined specific prefixes, 
there could be duplicate attribute names and prefixes that RealOne Player 
could not resolve. Suppose that two parties developed two new SMIL 
attributes, both called fd:find, but each defined against a different namespace. 
If you used both fd:find attributes in your presentation, RealOne Player would 
not know which attribute goes with which namespace. 


Because prefixes are user-definable, though, you could change the prefix for 
one of the attributes, making it xy:find, for example. You would then use the 
same xy prefix in the associated namespace so that RealOne Player could 
match each find attribute to its namespace. This provides flexibility for parties 
developing customized attributes, but it also places responsibility on the 
SMIL author to match customized attributes to namespaces through prefixes. 


Tips for Defining Namespaces 


+ To summarize, there are three required parts of a customized attribute: 
+ a user-defined attribute prefix such as rn: 


+ a predefined attribute and value pair that uses the prefix, such as 
rm:backgroundOpacity="50%”" 


+ a predefined namespace that includes the user-defined prefix. The 
attribute is always defined against a namespace, such as the 
RealNetworks extensions namespace: 


xmlns:rn=“http://features.real.com/2001/SMIL20/Extensions” 


+ Within the <smil> tag, you can declare each namespace on a separate line 
for easier reading. SMIL ignores extra spaces, carriage returns, line breaks, 
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and tabs used simply to align text in a file. Just make sure that the closing 
angle bracket of the <smil> tag appears after the last namespace. 


+ It’s OK to declare a namespace in the <smil> tag even if you don’t use any 
customized attributes associated with that namespace. 


+ Support for a customized attribute must be built into a media player. 
Other SMIL-based players may not support the same customized 
attributes as RealOne Player, and vice versa. But if a SMIL-based media 
player does not support a customized attribute, it simply ignores the 
attribute. 


Viewing SMIL Source Markup 


RealOne Player has a View>Clip>Clip Source command that shows the SMIL 
markup of the current presentation. Using this command is a good way to 
learn how a SMIL presentation is put together. The Helix Universal Server or 
Web server hosting the presentation sends the markup as an HTML page that 
opens in a RealOne Player pane, or your default Web browser. 


Access to SMIL source information is denied for secure presentations that 
require a user name and password. The Helix Universal Server administrator 
may also disallow access to the SMIL source file, or allow access to the source 
file but conceal the full paths of clips. When access is allowed, the Web page 
showing the SMIL syntax includes a hypertext link for each clip in the 
presentation. Clicking a link displays a new Web page with information about 
the corresponding clip, including its size, buffer time, and streaming bit rate. 


Playback Differences from SMIL 1.0 


If you have created SMIL 1.0 presentations for playback in RealPlayer G2, 
RealPlayer 7, or RealPlayer 8, this section will help bring you up-to-date with 
changes in SMIL 2.0. 


Behavioral Changes 


The SMIL 2.0 specification requires changes to RealOne Player’s handling of 
some basic features that carry over from SMIL 1.0: 


+ RealOne Player now treats clips without internal timelines, such as 
images, as having an intrinsic duration of 0 seconds. This means you must 
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include a dur or end attribute to make these clips display at all. For 
information on durations, see “Setting Durations” on page 317. 


A clip without a fill attribute defaults to fill=“auto”, which can be 
equivalent to fill=“remove” or fill="freeze” depending on the circumstance. 
See “Setting a Fill” on page 327. 


In a <par> group, a fill="freeze” attribute displays a clip only until the 
group ends. If the presentation ends when the group ends, the clip does 
not stay frozen on the screen as it did in SMIL 1.0. Instead, it is removed 
once the group is no longer active. To display a clip after its group ends, 
use fill=“hold” and erase="never” in the clip tag. For more information on 
these new attributes and values, see “Displaying a Clip Throughout a 
Presentation” on page 330. 


Updating SMIL 1.0 Files to SMIL 2.0 


A SMIL 1.0 presentation created for an earlier version of RealPlayer will play in 
RealOne Player. If you want to update a SMIL 1.0 presentation to SMIL 2.0, 
however, you have to change the <smil> 1.0 tag to a SMIL 2.0 tag: 


<smil xmlns=“http://www.w3.org/2001/SMIL20/Language”> 


The following table provides a quick reference for changing other SMIL 1.0 
tags and attributes to their SMIL 2.0 equivalents. Once you make these 
changes, you can add any other SMIL 2.0 features to your presentation. Your 
SMIL file will play only in RealOne Player, however. 


Tag and Attribute Changes from SMIL 1.0 to SMIL 2.0 


SMIL1.0 Element SMIL 2.0 Tag or Attribute Reference 

Layout Tags and Attributes 

background-color | backgroundColor page 290 

Clip Source Tags and Attributes 

?bitrate=nnnn <param name="bitrate” value="nnnn" page 210 
rn:delivery="server”/> 

?reliable=true <param name="reliable” value="true” page 212 
rn:delivery="server”/> 

?bgcolor=RRGGBB | <param name="bgcolor” value="RRGGBB" /> page 227 

Timing Tags and Attributes 

repeat repeatCount page 323 

clip-begin clipBegin page 316 


(Table Page 1 of 2) 
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Tag and Attribute Changes from SMIL 1.0 to SMIL 2.0 (continued) 


SMIL1.0 Element SMIL 2.0 Tag or Attribute Reference 
clip-end clipEnd page 316 
endsync="id(ID)” | endsync="ID" page 321 
Hyperlinking Tags and Attributes 

<anchor/> <area/> page 360 
show=“new” external=“true” sourcePlaystate="play” page 371 
show=“pause” external=“true” sourcePlaystate="pause” page 371 
target="ID" URL#ID page 381 
Switch Tag Attributes 

system-bitrate systemBitrate page 446 
system-language | systemLanguage page 443 
system-captions |systemCaptions page 448 


(Table Page 2 of 2) 
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CLIP SOURCE TAGS 


For every clip you play in your presentation, such as an audio clip, 
video clip, or text clip, you add a source tag to your SMIL file. This 
chapter explains the basics of clip source tags, explaining how to 
write URLs that tell RealOne Player where to find clips. It also tells 
how to modify certain characteristics, such as background 


transparency, when clips play. 


Creating Clip Source Tags 


Each time you want a clip to appear in a presentation, you write a clip source 
tag that tells RealOne Player where to find the clip. The source tag URL may 
point RealOne Player to a clip on Helix Universal Server, a Web server, or even 
the viewer’s local computer. A typical clip tag looks like this: 


<audio src="rtsp://helixserver.example.com:554/audio/song1.rm”/> 

Within each clip source tag, a src attribute lists the clip location. The section 
“Writing Clip Source URLs” on page 215 explains how to specify a URL with 
the src attribute. As described in subsequent chapters, clip source tags can also 
contain other attributes that control clip timing and layout. The following 
table lists the different clip source tags you can use in a presentation. 


Clip Source Tags 


Clip Tag Used For 
<animation/> animation clips such as a Flash Player file (.swf) 
<audio/> audio clips such as RealAudio (.rm) 
<brush/> color block used in place of a clip 
(See “Creating a Brush Object” on page 213.) 
<img/> JPEG (.jpg), GIF (.gif), or PNG images (.png) 
(See “Setting a Clip’s Streaming Speed” on page 210.) 
<ref/> miscellaneous clip type, such as RealPix (.rp) or Ram (.ram) file 


(Table Page 1 of 2) 
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Clip Source Tags (continued) 
Clip Tag Used For 


<text/> static text clips (.txt) or inline SMIL text 
(See “Adding Text to a SMIL Presentation” on page 227.) 


<textstream/> —_| streaming RealText clips (.rt) 


<video/> video clips such as RealVideo (.rm) 
(Table Page 2 of 2) 


The particular clip source tag you choose does not affect clip playback because 
RealOne Player determines the actual clip type by other means. Specifying a 
video clip with an <audio/> tag, for example, does not prevent RealOne Player 
from recognizing that the clip contains video. Although using a tag 
appropriate to the clip’s contents helps you keep track of clips, you could 
specify all clips with <ref/> tags, for example. Other clip tags cannot be used in 
place of the <brush/> tag, however. 


Adding a Clip ID 


RealNetworks recommends that every clip source tag include a user-defined 
ID in the form id="ID". Clip IDs are not always necessary, but you will need to 
use them when building complex presentations in which other SMIL elements 
refer to clips. Clicking a hyperlink, for example, can start a clip playing. In this 
case, the hyperlink uses the clip’s ID to identify which clip to start. RealOne 
Player never displays IDs onscreen. Here is an example of a clip ID: 


<video src="videol.rm” id="video1” /> 


For More Information: For information about selecting ID 
values, see “SMIL Tag ID Values” on page 202. 


Setting a Clip’s Streaming Speed 


Clips such as audio, video, and animation have a streaming speed set by the 
tools used to encode or tune the clips. For these clips, never use SMIL to set a 
streaming speed. For static clips such as images (GIF, JPEG, or PNG) and text 
(static text files and streaming RealText files), however, you can use SMIL to 
change the clip’s streaming bandwidth from the default of 12 Kilobits per 
second (approximately 12000 bits per second). This works only when 
streaming from Helix Universal Server. With Web server hosting, there is no 
way to set a static clip’s streaming speed. 
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Tip: Small text files stream so quickly that they rarely interfere 
with other clips. Therefore, you generally do not need to set the 
streaming bandwidth for text files. You should set a streaming 
bandwidth for image files larger than 5 Kilobytes, if the 12 
Kbps default value is too high or too low for your target 
audience. 


For More Information: For background information on 
streaming speeds, see “Audience Bandwidth Targets” on page 
47 and “Clip Bandwidth Characteristics” on page 48. 


Using the bitrate Parameter 


To set a static clip’s streaming speed, you modify the clip source tag to use 
binary tags, as described in the section “Binary and Unary Tags” on page 201. 
Within the binary clip tag, you add a <param/> tag with the name bitrate, 
specify the speed in bits per second, and include the customized attribute 
rm:delivery="server”, which requires that you declare the following namespace 
in the <smil> tag: 


xmlns:rn=“http://features.real.com/2001/SMIL20/Extensions” 


The following example sets an image to stream at approximately 5 Kilobits per 
second: 
<img src="poster.jpg” region="image_region” dur="15s”"> 

<param name="bitrate” value="5000" rn:delivery="server” /> 
</img> 
RealOne Player does not display an image clip until it has received all the clip’s 
data, and the clip is scheduled to display according to the SMIL timeline. For 
clips that have no intrinsic duration, such as images and text files (though not 
RealText clips), you must specify a duration. 


For More Information: For more on image durations, see 
“Setting Durations” on page 317. For background on 
customized attributes, see “Using Customized SMIL 
Attributes” on page 203. 


Example of Streaming Images Slowly 

Using the bitrate parameter, you can set a high streaming speed for a clip to 
take advantage of available bandwidth and stream the image quickly. Or you 
can set a low bit rate to ensure that streaming the image does not interfere 
with playing another clip at the same time. The following example shows 
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three sequential image files set to stream at 1000 Kbps to ensure that a video 
playing in parallel does not stall: 
<par> 
<video src="video.rm” region="video_region”/> 
<par> 
<seq> 
<img src="ad1.gif” begin="30s” dur="60s” region="ad_region”> 
<param name=" bitrate” value="1000” rn:delivery="server” /> 
</img> 
<img src="ad2.gif” dur="120s” region="ad_region”> 
<param name="bitrate” value="1000” rn:delivery="server” /> 
</img> 
<img src="ad3.gif” dur="60s” region="ad_region”> 
<param name=" bitrate” value="1000” rn:delivery="server” /> 
</img> 
</seq> 
</par> 
</par> 


For More Information: For more on SMIL timing, see Chapter 
13. Chapter 11 explains group tags such as <par> and <seq>. 


Ensuring Reliable Clip Transmission 


You can use the reliable value in a <param/> tag to indicate that a clip must be 
delivered to RealOne Player under any circumstances. During extremely 
adverse network conditions, Helix Universal Server will halt the presentation if 
necessary rather than drop the clip. The following example shows the reliable 
parameter set for an image. Note that this parameter also requires the 
customized attribute rn:delivery="server”: 
<img src="poster.jpg”> 

<param name="bitrate” value="5000" rn:delivery="server” /> 


<param name="reliable” value="true” rn:delivery="server” /> 
</img> 


Tip: Use the reliable parameter sparingly, and only for small, 
important elements of your presentation. Even without this 
parameter, Helix Universal Server generally ensures that very 
little data loss occurs in transmission. 


Warning! The reliable parameter is not for use with large clips 
such as videos. These clips are designed to play well even if 
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some data is lost in transmission. Using the reliable parameter 
with these clips may cause your presentation to stall. 


Creating a Brush Object 


The <brush/> tag lets you create a colored rectangle that displays in a region. 
You can use it to paint over a clip, for example. You can also use it like a 
background color. You might display a series of differently colored brush 
objects in a region behind a video for example, introducing each new brush 
object with a transition effect. To the viewer, the brush objects look like a 
dynamically changing region background. 


A brush object functions just like a clip source tag. For example, you can 
control when the brush object appears by using SMIL timing commands, and 
you can even change a brush object’s size and color with SMIL animation tags. 
Because it does not link to an external clip, though, the <brush/> tag does not 
use a src attribute. Instead, it uses a color attribute to define the color used: 


<brush color="blue” region="region_1” dur="5s"/> 


Black is the default color for a brush object. To specify a different color, use a 
predefined color name, a hexadecimal color value, or an RGB value. 


For More Information: Appendix C explains the types of color 
values that you can use with SMIL color attributes. For more 
on transition effects and animations, see Chapter 16 and 
Chapter 17, respectively. 


Using a Ram File as a Source 


Note: Currently, you can use a Ram file as a source within a 
SMIL file only if the Ram file lists audio-only clips that do not 
require a layout. 


A Ram file (.ram) is typically used to launch RealOne Player and give it the 
URL of the clip or SMIL presentation to play. But you can also use a Ram file 
as a source of content within a SMIL file. Because a Ram file can list several 
clips in sequence, you may find it useful to specify a Ram file (a different Ram 
file from the one used to launch the presentation) within your SMIL file. 


To illustrate how a Ram file is useful, suppose that your main SMIL 
presentation defines an online radio application that plays a preset song list 
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that changes daily. You could list all the songs within the SMIL file in a 
sequence, like this: 
<seq> 
<audio src="song1.rm”/> 
<audio src="song2.rm"/> 
...more Songs... 
</seq> 


Each day, though, you’d need to modify your main SMIL file to update the 
playlist. It’s easier in this case to have the SMIL file request a Ram file through 
a <ref/> tag: 


<ref src="http://www.example.com/dailysongs.ram”/> 


Note: Use an HTTP URL like that shown above when listing a 
Ram file as a source clip within a SMIL file. Helix Universal 
Server does not stream Ram files through RTSP. 


You then modify the Ram file each day with your new playlist. The Ram file 
simply gives the full URL to each song in the order in which they play: 
rtsp://helixserver.example.com/song1.rm 


rtsp://helixserver.example.com/song2.rm 
...More songs... 


When you use a Ram file as a source, you can add SMIL timing and layout 
attributes to the <ref/> tag. In a playlist of videos, for example, you could 
assign all the videos to play in the same region, which your main SMIL 
presentation would define. Or you could use timing attributes to give the 
entire sequence of clips a maximum duration, for instance. You cannot use 
SMIL attributes within a Ram file, however. 


For More Information: For more on Ram files, see “Launching 
RealOne Player with a Ram File” on page 507. Note that a Ram 
file can also list other Ram or SMIL files, as well as clips. 


Using a SMIL File as a Source 


Note: Currently, you can use a SMIL file as a source only if it 
lists audio-only clips that do not require a layout. 


A SMIL file can also use another SMIL file as a source. Simply use a <ref/> tag 
to refer to the secondary SMIL file: 


<ref src="rtsp://helixserver.example.com/presentation2.smil” /> 
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Unlike a Ram file, a SMIL file can do more than list a simple sequence of clips. 
A secondary SMIL file can play clips in parallel, for example, and use SMIL 
timing and layout attributes to organize its clips. 


Handling Layouts 


When a secondary SMIL file contains visual clips, you assign the entire SMIL 
file to play within a region defined in the primary SMIL file: 

<ref src="rtsp://helixserver.example.com/presentation2.smil” 
region="region_1”/> 

In this case, it’s best to define the playback region in the main SMIL file 
(region_1) to be the same size as the root-layout area of the secondary SMIL 
file. If the playback region and the secondary SMIL presentation are different 
sizes, the playback region’s fit attribute determines how the SMIL 
presentation fits the region. 


For More Information: For information on defining layouts and 
assigning clips to play in regions, see Chapter 12. 


Using Timing Attributes 


Timing attributes in the primary SMIL file can override the timeline of the 
secondary SMIL file. Suppose that presentation2.smil lasts 10 minutes when 
played by itself, but you set a 5-minute duration in the <ref/> tag in the main 
SMIL file: 


<ref src="rtsp://helixserver.example.com/presentation2.smil” dur="5min” /> 


In this case the duration specified in the main SMIL file cuts off the last half 
of presentation2.smil. 


For More Information: Timing attributes are described in 
Chapter 13. 


Writing Clip Source URLs 


Every clip source tag, except for a <brush/> tag, requires an src attribute that 
provides the URL for the clip. RealOne Player uses this URL to request the clip 
from a server. The URL you specify varies depending on whether the clip 
resides on Helix Universal Server, a Web server, or the viewer’s local machine. 


Tip: As you develop a presentation on your computer, use local 
URLs. Then put in a base URL, or specify full URLs for each 
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clip, when you are ready to stream your presentation. Chapter 
21 explains how to move clips to a server and write a Ram file 
to launch RealOne Player. 


Linking to Local Clips 


As you develop your presentation, it is easiest to keep your SMIL file and your 
clips in the same directory on your local computer. Within your SMIL file, the 
src parameter for each clip source tag can simply give the file name: 


<audio src="song1.rm"/> 


Creating Relative Links to Other Directories 


RealOne Player can also follow the same relative links that you can use ina 
Web page. For example, the following src attribute specifies a clip that resides 
one level below the SMIL file in the audio folder: 


<audio src="audio/song1.rm"/> 

The following example specifies a clip that resides one folder level above the 
SMIL file: 

<audio src="../song1.rm”/> 

The next example creates a link to a clip that resides in an audio folder that is 
at the same level as the folder that contains the SMIL file: 

<audio src="../audio/song1.rm”/> 


Tip: You can find additional information about relative 
directory syntax in an HTML reference guide. 


Writing Absolute Links 


Alternatively, you can use local, absolute links to specify exact locations. The 
syntax for absolute links is the same as with HTML. It varies with operating 
systems, however, and you should be familiar with the directory syntax for the 
system you are using. For example, the following absolute link syntax works 
for Windows computers, but not on Unix or the Macintosh. Note that it 
includes three forward slashes in file:///, and uses forward slashes in path 
names as well: 


src="file:///c:/audio/first.rm” 
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Creating a Base URL 


When you are ready to stream your presentation, you can add a base URL to 
your SMIL file. This is convenient if all or most of your clips reside on the 
same server. This preserves the local, relative syntax you used when developing 
your presentation, readying your presentation for streaming in a single step. 
You add the base URL to the file in the SMIL header section through a 
<meta/> tag as shown here: 
<smil xmlns=“http://www.w3.org/2001/SMIL20/Language”> 
<head> 
<meta name="base” content="rtsp://helixserver.example.com/"/> 
...layout information... 
</head> 
<body> 
<par> 
<audio src="song1.rm” /> 
<textstream src="Llyrics/words1.rt” .../> 
<img src="http://www.example.com/images/album3.gif” .../> 


</par> 
</body> 
</smil> 


Because the third clip in this example uses a full URL, the base target is 
ignored. RealOne Player requests the image from the specified Web server 
using the HTTP protocol. For the first two clips, however, the src values are 
appended to the base target, effectively giving the clips the following URLs: 


rtsp://helixserver.example.com/song1.rm 
rtsp://helixserver.example.com/Lyrics/words1.rt 


Using a base target is highly recommended. If no target is given, RealOne 
Player assumes that the clip paths are relative to the location of the SMIL file. 
In the preceding example, for instance, RealOne Player would look for 
songi.rm in the same directory that holds the SMIL file, requesting the clip 
with the same protocol used to request the SMIL file. 


Keep in mind that the base URL specifies both a location and a request 
protocol. If, for example, your SMIL presentation includes both streaming 
clips and HTML pages opened through SMIL, you can place your clips and 
HTML pages in the same directory on Helix Universal Server. However, if your 
base URL uses rtsp://, you can’t use the base URL for the HTML pages, which 
require a URL that starts with http://. In this case, use a fully-qualified HTTP 
URL for each HTML page listed in your SMIL file. 
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Linking to Clips on Helix Universal Server 


When clips reside on Helix Universal Server, use an RTSP URL in the base 
target. Or, you can specify an RTSP URL in each clip’s src attribute. An RTSP 
URL in a clip source tag looks like this: 


<audio src="rtsp://helixserver.example.com:554/audio/first.rm” /> 


The following table explains the URL components. Your Helix Universal 
Server administrator can give you the Helix Universal Server address, RTSP 
port, and directory structure. 


Helix Universal Server URL Components 
Component Specifies 


rtsp:// RTSP protocol. Although Helix Universal Server also 
supports HTTP, streaming clips typically use RTSP. 


helixserver.example.com | Helix Universal Server address. This varies with each 
Helix Universal Server. It typically uses an identifier such 
as helixserver instead of www. Or it may use a TCP/IP 
address (such as 172.2.16.230) instead of a name. 


2554 Helix Universal Server port for RTSP connections. Port 
554 is the default, so you can leave this out of URLs 
unless the Helix Universal Server administrator chose a 
different port for RTSP communication. If the port 
number is required, separate it from the address with a 
colon. 


/audio/ Helix Universal Server directory that holds the clip. The 
directory structure may be several levels deep. Helix 
Universal Server also uses “mount points” that invoke 
certain features, such as password authentication. 
Because these mount points appear to be directories in 
the URL, the request path does not mirror the actual 
directory path on the Helix Universal Server computer. 
The Helix Universal Server administrator can tell you the 
mount points and directories in the path. 


first.rm Clip file name. 


For More Information: For more information on RTSP, see “The 
Difference Between RTSP and HTTP” on page 505. 
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Linking to Clips on a Web Server 


To use a clip hosted on a Web server, use a standard HTTP URL in the base 
target, or in each clip’s src attribute. Helix Universal Server also supports the 
HTTP protocol, but for clips streaming from Helix Universal Server, you 
typically use the RTSP protocol or the specialized CHTTP protocol, which is 
described in the following section. An HTTP URL in a clip source tag looks 
like this: 


<img src="http://www.example.com/images/logo.gif”/> 


Warning! Although a Web server can host any clip, a Web server 
cannot perform all the functions of Helix Universal Server. For 
more information, see “Limitations on Web Server Playback” 
on page 524. 


Caching Clips on RealOne Player 


RealOne Player does not cache clips that play in the media playback pane by 
default, but you can make it cache on disk any clips delivered through HTTP. 
You may want to cache images used in different SMIL presentations that site 
visitors play. An example is an Internet radio station that uses GIF logos and 
on-screen buttons. As long as the GIFs reside in the RealOne Player cache, the 
server does not have to resend the files if, for example, the user clicks a link 
that opens a new SMIL presentation containing the same images. 


Caching works only for files delivered through HTTP. You should not try to 
cache large clips that would be served better through RTSP, such as video, 
audio, Flash, and RealPix clips. (RealOne Player caches RealPix images in 
memory, but not on disk, for the duration of the RealPix presentation.) Nor 
should you cache ads or images that do not appear repeatedly in your 
presentation. 


For More Information: For information about the caching of 
content that displays in the related info pane, see “HTML Page 
Caching” on page 36. 


Using the CHTTP Caching Protocol 


RealOne Player does not cache all items streamed by HTTP. Instead, you 
designate files to cache by using chttp:// instead of http:// in the file URLs. 
When RealOne Player reads a CHTTP URL in a SMIL file, it first checks its 
disk cache for the file. If the file is not present, RealOne Player requests the file 
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through HTTP, storing the file in its cache. Because RealOne Player interprets 
a chttp:// URL as a special instance of HTTP, caching works for any file stored 
on an HTTP-compatible server. 


If a file is stored in RealOne Player’s cache, RealOne Player reuses the file 
instead of requesting it again from the server, as long as a CHTTP URL is 
used. The cached version is not used, though, if the URL starts with http:// or 
differs in any way from the original CHTTP URL. The following SMIL 
example indicates that the specified GIF image should be downloaded and 
cached for later use: 


<img src="chttp://www.example.com/images/image1.gif” .../> 


Example of Using CHTTP in a Presentation 

When caching files, download the cached items before streaming other 
elements. You can do this by placing the cached elements in a SMIL <seq> 
group ahead of the streamed elements. In the following example, the two 
logos quickly download before the RealVideo and RealText clips play. If the 
visitor plays another presentation that also caches the two images, RealOne 
Player first checks its cache. If it finds the images, it skips directly to the 
streaming clips: 


<smil xmlns=“http://www.w3.org/2001/SMIL20/Language”> 
...header omitted... 
<body> 
<seq> 
<!-- First, download and cache these two logos. --> 
<img src="chttp://www.example.com/logo1.gif region="logo1” ...> 
<param name="bitrate” value=”20000” rn:delivery="server”/> 
</img> 
<img src="chttp://www.example.comlogo2.gif region="logo2” ...> 
<param name="bitrate” value="20000” rn:delivery="server”/> 
</img> 
<par> 
<!--Second, stream these 2 clips in parallel. --> 
<textstream src="rtsp://helixserver.example.com/news.rt” region="news” .../> 
<video src="rtsp://helixserver.example.com/newsvid.rm” region="video1” .../> 
</par> 
</seq> 
</body> 
</smil> 
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Controlling the RealOne Player Cache 


Because RealOne Player supports the same HTTP header fields used to 
control file expiration in Web browser caches, it can carry out caching 
directives set by Web servers. Thus, you can reuse Web page images in RealOne 
Player presentations without losing control of how these images are cached. 
This section describes how to use HTTP headers to control the RealOne Player 
cache, and how RealOne Player manages its cache. Documentation for most 
Web servers includes information about how to set fields in HTTP header 


files. 


Overriding Caching with Cache-Control 

The Cache-Control command of an HTTP header file can override caching of a 
RealOne Player file requested through chttp://. A file requested through 
CHTTP is not cached if any of the following are present as meta-information 
in the HTTP header file: 


* Cache-Control:no-cache 

¢ Cache-Control:no-store 

* Cache-Control:private 

¢ Cache-Control:must-revalidate 


Cache Size and Expiration Rules 

RealOne Player caches files within its home directory in a folder named 
cache_db. This cache is independent of any Web browser cache. The default 
RealOne Player cache size is 4 MB. Unless an HTTP header sets a file lifetime, 
the cached file expires after 4 hours, although a subsequent request for a 
cached item restarts the item’s expiration clock. As the cache fills, RealOne 
Player begins to delete unexpired items to reclaim needed disk space on a first- 
in, first-out basis. 


Note: RealOne Player users can control some aspects of 
RealOne Player’s cache by disabling the cache, setting the 
amount of disk space available for the cache, and emptying the 
cache. Users carry out these actions through the RealOne 
Player preferences. For more information, see the RealOne 
Player online help. 


Changing the Lifetime of a Cached File 

Within an HTTP header, you can have Cache-Control:max-age set the “time to 
live” (TTL) for a cached file, overriding the default expiration time. Expressed 
in seconds, the maximum age is added to the current time to yield the file’s 
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expiration time. This value must be between 60 seconds and one year. For 
example: 


Cache-Control:max-age=172800 
If you do not use the Cache-Control:max-age field, you can have the Expires field 
determine the file’s expiration time. The Expires field takes as an attribute a 


date string that defines when the cached element expires, relative to the 
caching computer’s clock. The date string is formatted as follows: 


Expires= Wdy, DD Mon YYYY HH:MM:SS GMT 


The weekday is optional. In the following two examples, the first example 
includes a weekday designation, the second one does not: 


Expires= Fri, 17 Mar 2000 19:37:09 GMT 
Expires= 17 Mar 2000 19:37:09 GMT 
The weekday and month abbreviations are as follows: 


Day of week: Mon, Tue, Wed, Thu, Fri, Sat, Sun 
Month: Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, Dec 


Note: The entry is not cached if the value in the Expires: field 
predates the current date and time. 


Modifying Clip Colors 
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The clip color attributes summarized in the following table are primarily for 
images in the GIF, JPEG, or PNG format. They can also be used for dynamic 
clips, though, especially those that include transparency, such as Flash clips. 
They should not be used for streaming video, however. Note that because 
these attributes are specific to RealOne Player, other SMIL-based media 
players may not recognize them. 


Clip Streaming and Color Attributes 


Attribute Value Function Reference 
“‘tn:backgroundOpacity | percentage | Adjusts background transparency. | page 223 
bgcolor nnnnnn Substitutes color for transparency. | page 227 
rn:chromaKey color_value | Turns selected color transparent. | page 224 
r:chromaKeyOpacity | percentage | Adds opacity to chromaKey. page 225 


(Table Page 1 of 2) 
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Clip Streaming and Color Attributes (continued) 


Attribute Value Function Reference 


rn:chromaKeyTolerance Widens range of chromaKey. 


rn:mediaOpacity Makes opaque colors transparent. 


(Table Page 2 of 2) 


For More Information: Appendix C explains the types of color 
values you can use with SMIL color attributes. 


Adjusting Clip Transparency and Opacity 


Two customized attributes let you add transparency to all opaque colors in a 
clip (rn:mediaOpacity), or adjust transparency in just the clip’s background 
color (rn:backgroundOpacity). You can use these attributes separately or 
together. Using either of these attributes requires that you declare the 
following namespace in the <smil> tag: 


xmlns:rn=“http://features.real.com/2001/SMIL20/Extensions” 


For More Information: For the basics of namespaces, see “Using 
Customized SMIL Attributes” on page 203. 


Adding Transparency to All Opaque Colors 


The attribute rn:mediaOpacity in a clip source tag causes opaque areas in the 
clip to become transparent. The attribute takes a percentage value in the range 
from 0% (fully transparent) to 100% (fully opaque). In the following example, 
the opaque areas of a GIF image are rendered partially transparent, making 
them blend with a region’s background color or an underlying clip: 


<img src="button.gif” rn:mediaOpacity="50%” .../> 


Note: Ifa clip is 50 percent or more transparent (that is, it has a 
value from 0 to 50 for rn:mediaOpacity), hyperlinks defined for 
the clip will not work. Clicking the clip will open hyperlinks on 
clips beneath the partially transparent clip, however. Chapter 
15 explains SMIL hyperlinks. 


Creating Transparency in a Clip’s Background Color 


Using the rn:backgroundOpacity attribute, you can modify the opacity of a clip’s 
background, making the background color more transparent or more opaque. 
This attribute works only for clips that designate a specific background color, 
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such as GIF, PNG, or RealText clips. It does not work for clips like JPEG 
images or RealVideo clips that do not explicitly specify a background color. 


The rn:backgroundOpacity attribute takes a percentage value in the range from 
0% (fully transparent) to 100% (fully opaque). In the following example, the 
background color specified in the image’s palette, which may be fully opaque 
or fully transparent, is rendered partially opaque: 


<img src="button.gif” rn:backgroundOpacity="50%" .../> 


If the background color is partially transparent already, rn:backgroundOpacity 
increases the opacity. If a clip’s background is 50 percent transparent already, 
for example, using rn:backgroundOpacity="50%" adds another 50 percent to the 
opacity, making the background 75 percent opaque. 


Tip: If a clip’s background is fully opaque, you can use just 
rm:mediaOpacity to render the background and all other colors 
transparent. If the clip’s background is partially transparent 
already, rn:mediaOpacity will not affect the background, and you 
can use both rn:mediaOpacity and rn:backgroundOpacity in the 
same clip tag. 


Substituting Transparency for a Specific Color 


For clips that do not include native transparency, such as JPEG images and 
Flash clips, you can use three attributes to define a color (rn:chromaKey), or a 
range of colors (rn:chromaKeyTolerance), that RealOne Player renders 
transparent or partially transparent (rn:chromaKeyOpacity). Using these 
attributes requires that you declare the following namespace in the <smil> tag: 


xmlns:rn=“http://features.real.com/2001/SMIL20/Extensions” 
For More Information: For background on customized 


attributes, see “Using Customized SMIL Attributes” on page 
203. 


Selecting a Color to Render Transparent 


You can use rn:chromaKey to specify one (and only one) color that RealOne 
Player will render transparent. In the following example, the hexadecimal 
color #808080 is made transparent in a JPEG clip: 


<img src="picture.jpg” rn:chromaKey="#808080”".../> 
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Tip: You can specify colors by using any color value described 
in Appendix C. For example, the preceding attribute could use 
the RGB value “rgb(128,128,128)” instead of the hexadecimal 
“#808080”. 


Using Partial Transparency 


You can use the rn:chromaKeyOpacity attribute to make the color value selected 
by rn:chromaKey partially transparent instead of fully transparent. The 
chromaKeyOpacity attribute uses a percentage value from 0% (the default value 
of full transparency) to 100% (fully opaque). In the following example, the 
selected color is rendered 50 percent transparent instead of fully transparent: 


<img src="picture.jpg” rn:chromaKey="#808080” rn:chromaKeyOpacity="50%" /> 


Expanding the Transparency Range 


To achieve the desired transparency effect, you may need to use the attribute 
rm:chromaKeyTolerance to widen the range of colors selected by rn:chromaKey. 
Although rn:chromaKeyTolerance uses a value that looks like a single color 
designation, the value actually specifies a range of colors around (both above 
and below) the rn:chromaKey value. 


The following example uses rn:chromaKey to turn the hexadecimal color 
#808080 transparent. The rn:chromaKeyTolerance attribute specifies a 1-value 
tolerance both above and below the designated red value of 80. So in this case, 
the colors #7F8080 and #818080 are rendered transparent along with #808080: 


<img rn:chromaKey="#808080" rn:chromaKeyTolerance="#010000”.../> 


Setting Red, Green, and Blue Tolerances 

In most cases, you’ll want to specify tolerance ranges for red, green, and blue. 
When you do this, only the colors that fall within the overall range set by all 
the designated tolerances are rendered transparent. For example, the following 
three attribute pairs are all equivalent, but use different color values, which are 
described in Appendix C: 

rn:chromaKey="rgb(128,128,128)” rn:chromaKeyTolerance="rgb(1,2,3)” 
rn:chromaKey="rgb(50%,50%,50%)” rn:chromaKeyTolerance="rgb(0.4%,0.8%,1.2%)” 
rn:chromaKey="#808080" rn:chromaKeyTolerance="#010203” 


All of the preceding examples define a 1-value tolerance around the specified 
red value, a 2-value tolerance around the designated green value, and a 3-value 
tolerance around the selected blue value. Therefore, the colors that have the 
following RGB values are rendered transparent: 
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« red RGB values 127-129 
(red hexadecimal values of 7F, 80, and 81) 


-And- 


+ green RGB values 126-130 
(green hexadecimal values of 7E, 7F, 80, 81, and 82) 


-And- 


+ blue RGB values 125-131 
(blue hexadecimal values of 7D, 7E, 7F, 80, 81, 82, and 83) 


So, for example, the following colors would be rendered transparent because 
they fall within the range specified by all three tolerance settings: 


+ rgb(127,128,130), which is equivalent to hexadecimal #7F8082 
+ rgb(128,129,125), which is equivalent to hexadecimal #80817D 


However, the following colors would not be rendered transparent because they 
fall outside the overall range defined by all the red, green, and blue tolerance 
values: 


+ rgb(126,126,126), which is equivalent to hexadecimal #7E7E7E 


This color is not rendered transparent because the red value falls outside 
the designated red tolerance, even though the green and blue values fall 
within the designated green and blue tolerances. 


+ rgb(127,128,132), which is equivalent to hexadecimal #7F8084 


This color is not rendered transparent because the blue value falls outside 
the designated blue tolerance, even though the red and green values fall 
within the designated red and green tolerances. 


Tips for Expanding the Color Transparency Range 
+ The rn:chromaKeyTolerance attribute is always used in conjunction with 
rm:chromaKey. If you use rn:chromaKeyTolerance without also specifying 
rm:chromaKey, the rn:chromaKeyTolerance value is ignored. 


- Although you can use any type of color value described in Appendix C for 
rm:chromaKeyTolerance, RGB percentages are generally the simplest means 
for expanding the transparency range. Instead of precisely determining in 
advance the range of colors you want to render transparent, select your 
r:chromaKey value, then widen the range with a small percentage value: 


r:chromaKey="rgb(45,199,132)” rn:chromaKeyTolerance="rgb(5%,5%,5%)” 
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Check the results by playing the SMIL file in RealOne Player, and adjust 
the various percentage values through trial and error until you achieve 
your desired result. 


- As explained in the preceding section, a color must fall within the full 
range of the red, green, and blue tolerances to be rendered transparent. If 
you want to match all values for red, green, or blue, set its respective 
tolerance to the maximum. Consider the following equivalent examples: 


rn:chromaKey="rgb(128,128,128)” rn:chromaKeyTolerance="rgb(1,255,255)” 
rn:chromaKey="#808080” rn:chromaKeyTolerance="#01FFFF” 
Both of these examples render transparent any color that has a red value 


in the RGB range of 127 to 129 (7F, 80, 81), regardless of that color’s blue 
and green values. 


Substituting a Color for Transparency 


For clips that include transparency, such as GIF and PNG images, you can use 
bgcolor to substitute a color for the transparency. This attribute uses a 
<param/> tag, requiring the use of binary clip source tags. The value must be a 
hexadecimal color value without a leading pound sign (#), as shown in this 
example: 
<img src="button.gif”...> 

<param name="bgcolor” value="BB21AA”/> 
</img> 


For More Information: For background information on binary 
tags, see “Binary and Unary Tags” on page 201. 


Adding Text to a SMIL Presentation 


Within the RealOne Player media playback pane, a SMIL presentation can 
display text in three different ways: 


+ RealText clip (.rt) 


Chapter 6 explains RealText markup, which is the most powerful way to 
add text to your presentation. Within the SMIL presentation, SMIL 
timing and layout commands control where and when the RealText clip 
plays. As the clip plays, though, the RealText markup controls where and 
when text displays within its assigned SMIL region. 
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+ Plain text clip (.txt) 
RealOne Player can also display plain text files within SMIL regions. 


Although plain text files do not provide control over fonts and text sizes, 
you may find them adequate for simple text needs. For details, see 
“Displaying a Plain Text File” on page 228. 

¢ Text within the SMIL file 


RealOne Player supports the inclusion of text directly within the SMIL 
markup. Called inline text, this feature is useful for annotating a SMIL 
presentation, or creating simple, interactive buttons. For more 
information, see “Writing Inline Text” on page 229. 


Tip: RealOne Player can also display HTML text in its related 
info and media browser panes. For information on opening an 
HTML page in one of these panes, see “Linking to HTML 
Pages” on page 371. 


Displaying a Plain Text File 


To add a plain text file to a SMIL presentation, you simply refer to the file ina 
clip source tag, as shown here: 


<text src="http://www.example.com/textfile.txt” region="region2” dur="40s".../> 


As with any other type of clip, you can assign a text file to a SMIL region and 
use SMIL timing commands to control when the text file displays. Plain text 
clips currently use the Times New Roman font with 16-pixel-high character 
bounding boxes. The character set is US-ASCII. 


Tips for Using a Plain Text File 


+ Like a still image, a plain text file does not have an intrinsic duration. It 
therefore plays for as long as the group that contains it is active. You can 
also set an explicit clip length in the <text/> source tag with the end or dur 
attribute. For more on durations, see “Setting Durations” on page 317. 


+ RealOne Player displays carriage returns, tabs, and extra spaces entered in 
a plain text file. 


- All characters entered in the text file are treated literally, meaning that 
escape codes (%20, for example) or HTML commands (&lt;, for instance) 
display as text. 
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+ RealOne Player flows the text file’s line length to the width of the SMIL 
region that displays the text file. It changes this line length and reflows 
the text if the region width changes because, for example, the viewer 
resizes the media playback pane manually. Resizing the region or media 
playback pane does not make the text itself larger or smaller, however. 


For More Information: For more on region sizes, see “Defining 
Region Sizes and Positions” on page 281. As described in 
“Controlling Resize Behavior” on page 279, you can prevent 
certain SMIL regions from resizing. 


The use of a registration point can affect where the plain text file displays 
within the SMIL region. This can, in turn, affect how much text displays 
within the region. For additional information, see “Positioning Clips in 
Regions” on page 29S. 


The only region fit value that affects a text file is fit=“scroll”, which adds 
scroll bars to long files. With any other fit value, text that is too long to 
display in the region fully is cut off at the region’s bottom border. The fit 
attribute is described in “Fitting Clips to Regions” on page 301. 


Writing Inline Text 


Inline text, which is defined within the SMIL file, is useful for short text 
blocks that annotate the SMIL presentation. You can also combine inline text 
with advanced SMIL timing commands to create interactive buttons. For long 
text, however, it is easier to use either a plain text file as described above, or a 
RealText clip as described in Chapter 6. 


Inline text appears as black text on a white background, using the default text 
font, size, and character set for the computer running RealOne Player. You 
create inline text with a <text/> tag, specifying the text through the tag’s src 
attribute. Two formats for the src parameter are acceptable. The first format is 
the following: 


src=“data:text/plain,...text here...” 
The second, shorter format is used for examples in this guide: 
src=“data:,...text here...” 


Note that both formats start with data: and must include a comma before the 
actual text. For example, to display the following text in the SMIL file: 


This is Inline Text 
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you would create the following <text/> tag, assigning the inline text to a SMIL 
region and adding SMIL timing commands: 


<text src="data:,This%20is%20Inline%20Text” region="text_region” .../> 
Note that you must use the escape character %20 for spaces. As explained 


below, you must use escape characters to represent certain characters within 
inline text. 


Using Inline Text Escape Characters 


The following table lists the text characters that you can add to inline text only 
through their corresponding escape codes. Entering one of these characters 
directly in the inline text creates an error in RealOne Player. 


Text Characters Requiring Escape Codes 


Name Character Escape Code 
ampersand & 02.6 
backslash \ %5C 
carat i %5E 
carriage return %0D 
double quote e %o22 
greater than sign > %3E 
left bracket [ %5B 
less than sign < %3C 
line feed %0A 
percent sign %o 25 
pound sign # 23 
right bracket ] %5D 
space %20 
tab %09 


You can enter other common text characters, such as commas, periods, and 
colons directly into the src value of the inline text. Conversely, you can display 
any text character, including letters and numbers, by using an escape code that 
starts with % followed by the character’s ASCII hexadecimal value. You can 
create an asterisk (*) with the escape code %2A, for example. 


For More Information: Visit http://www.asciitable.com/ for a 
full list of ASCII codes. 
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Tips for Using Inline Text 


Do not press Enter to create a carriage return when entering inline text in 
the SMIL file. The carriage return is read as an unescaped space, which 
causes an error. To enter text on a new line, use the carriage return and 
line feed escape codes of %0D%0A. 


Because an inline text clip does not have an intrinsic duration, you should 
set a clip length in the <text/> source tag with the end or dur attribute. For 
more on durations, see “Setting Durations” on page 317. 


RealOne Player sets the inline text line length to the width of the SMIL 
region that displays the text file. It changes this line length and reflows 
the text if the region width changes because, for example, the viewer 
resizes the media playback pane manually. Resizing the region or media 
playback pane does not make the text itself larger or smaller, however. 


For More Information: For more on region sizes, see “Defining 
Region Sizes and Positions” on page 281. As described in 
“Controlling Resize Behavior” on page 279, you can prevent 
certain SMIL regions from resizing. 


The use of a registration point can affect where inline text displays within 
the SMIL region. This can, in turn, affect how much text displays within 
the region. For additional information, see “Positioning Clips in Regions” 
on page 295. 


The only region fit value that affects inline text is fit=“scroll”, which adds 
scroll bars to long text. With any other fit value, text that is too long to 
display in the region fully is cut off at the region’s bottom border. The fit 
attribute is described in “Fitting Clips to Regions” on page 301. 


Because inline text functions like a clip, you can use it with advanced 
timing features to turn the inline text into a button that starts another 
clip when clicked, for example. You can also use transition effects, SMIL 
animations, and the clip transparency attributes described in “Adjusting 
Clip Transparency and Opacity” on page 223. 
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ORGANIZING A PRESENTATION 


Using SMIL, you can pull together simple or highly complex 
presentations. Chapter 10 shows how to make presentations 
accessible to all viewers. Chapter 11 explains how to group clips 
together to set up the basic presentation timeline. You’ll also 
need to know how to organize the onscreen layout, as described 
in Chapter 12. 


PART 


CHAPTER 


10 


PRESENTATION INFORMATION 


RealOne Player provides several means for delivering information 
about a presentation, such as its title, author, and copyright. This 
chapter covers these information features, and explains the 


accessibility features available for sight-impaired persons. 


Understanding Presentation Information 


There are several types of presentation information available. Some types 
augment other types, some types override other types, and some types are 
available only to viewers who have devices that read accessibility information. 


Information Encoded in Clips 


Many clips have their own encoded information. When you create a RealVideo 
or RealAudio clip, for example, you can have Helix Producer encode certain 
types of information into the clip. Some of this information is used only by 
Internet search engines, but some is read by RealOne Player. The following are 
the most common types of information encoded into clips for display by 
RealOne Player: 


+ title 

+ author 

* copyright 

+ abstract (also called “description”) 


In general, it’s good practice always to encode information in the clip. This 
ensures that important information, such as a copyright, is present if the clip 
is not streamed using SMIL. Encoded information is the most basic level of 
presentation information, but you can override it using SMIL. 
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For More Information: See the documentation for your 
production tool for instructions on how to encode 
information into a clip. 


Clip Source Tag and Group Information 


A SMIL clip source tag, such as <video/> or <ref/>, can define title, author, 
copyright, and abstract information for the clip. There are two main 
advantages to defining this information in SMIL: 


+ You can provide information for any clip, which is handy for clips that do 
not encode any information internally. 


+ The SMIL information overrides the encoded clip information, letting 
you modify information without re-encoding the clip. 


You can also define title, author, copyright, and abstract information for 
groups. This information then overrides the information defined for the 
individual clips. When several clips play in parallel, for example, RealOne 
Player does not display the title for each clip individually. You may therefore 
want to define a single group title that RealOne Player displays while the 
group Is active. 


For More Information: The section “Adding Clip and Group 
Information” on page 238 describes how to add information to 
clip source tags and group tags. For more on groups, see 
Chapter 11. 


SMIL Presentation Information 


Within a SMIL file, you can define information for the entire presentation. 
This information supplements the clip or group information, but does not 
override it. This enables you to present two-levels of information to viewers: 


- The presentation information lasts for the entire presentation. 
- The clip or group information lasts only as long as each clip or group 
plays. 
Like clip information, the presentation information can give the title, author, 


copyright, and abstract. But you can also define any other information you 
wish through the header section <meta/> tags. 
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For More Information: The section “Defining Information for 


the SMIL Presentation” on page 240 explains how to write the 


<meta/> tags. 


Accessibility Information 


The accessibility features define a different class of information. RealOne 
Player typically does not display this information. Instead, the information is 


read by assistive devices used by sight-impaired persons. This information can 
help these viewers choose which clips to play, and which links to click. 


For More Information: See “Adding Accessibility Information” 


on page 241 for more information on these features. 


RealOne Player Related Info Pane 


RealOne Player has a built-in related info pane meant for displaying 
information as a presentation plays. Through SMIL, you can open HTML 
pages in the related info pane at any point in a presentation. This HTML page 
can augment the presentation information described in this chapter. 


Coded Characters 


For More Information: See “Opening HTML Pages in the Related 


Info Pane” on page 373 for more information. 


In a SMIL header section, or within clip attribute values, quotation marks, 


apostrophes, ampersands, and angle brackets are interpreted as syntax 


markers. You need to use codes to have these characters show up as text in 
RealOne Player. As shown in the following table, codes begin with an 


ampersand (“&”) and end with a semicolon ( 


Dp) 


the same way as popular Web browsers. 


SMIL Coded Characters 


66,99 


). SMIL interprets these codes 


Code Character Example 
&quot; quotation mark 

&amp; ampersand & 
&apos; apostrophe ‘ 

&lt; left angle bracket (“less than” sign) < 

&gt; right angle bracket ("greater than” sign) | > 
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For example, to add the following as a title: 
Multimedia’s <smil> & you 

You enter this in the SMIL file: 
"&quot;Multimedia&apos;s &lt;smil&gt; &amp; you&quot;” 


Adding Clip and Group Information 


The SMIL title, author, copyright, and abstract attributes let you add 
information to clip source tags and the <seq> and <par> group tags. This 
information overrides any similar information encoded within the clip itself. 
The following table summarizes these descriptive attributes. 


Clip and Group Information Attributes 


Attribute Value Function 
abstract clip_abstract Sets a summary displayed in the “Now Playing” list. 
author author_name Defines the author name. 


copyright |copyright_notice | Provides a copyright notice. 


title title_text Creates a title for the “Now Playing” list. 


Each attribute takes a text string for its value. The following example shows 
the general form these attributes take in a clip source tag: 


<ref src="...” title=“title” author=“name” copyright=“date” abstract=“abstract” /> 


Where Title, Author, and Copyright Information Displays 


Whether information is encoded in the clip, or added through SMIL or a Ram 
file, it appears in the following areas of RealOne Player: 


+ Title, author, and copyright information for a clip or group crawls 
horizontally along the title bar at the top of RealOne Player, unless the 
SMIL file also uses presentation information as described in “Defining 
Information for the SMIL Presentation” on page 240. In this case, only the 
presentation information appears in the title bar. 


+ Clip or group title and author information appears in the “Now Playing” 
list, which is part of the RealOne Player media browser pane. Viewers can 
double-click a clip or group listing to play that clip. For an example of this 
list, see the figure “RealOne Player ‘Now Playing’ List” on page 37. 
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+ Clip title information appears in the recent clips list under the RealOne 
Player File menu, unless the SMIL file also includes a presentation title as 
described in “Defining Information for the SMIL Presentation” on page 
240. In this case, only the presentation title appears in the list. 


+ Clip title, author, and copyright information appears when the viewer 
gives the View>Clip>Clip Info command (Ctrl+i). 


Tip: You can use any combination of title, author, copyright, and 
abstract attributes in each group or clip source tag, but 
RealNetworks highly recommends that you always include title 
attribute values. If a title is not encoded in the clip or specified 
through a title attribute, the clip’s file name is used instead. 


Using Clips Within Groups 


When you have a sequence of individual clips, you can display title and author 
information in the “Now Playing” list by omitting a <seq> tag, as described in 
“Creating Sequences Without Sequence Tags” on page 248. When you leave 
the <seq> tag out, as shown in the following example, the individual clip titles 
display in RealOne Player: 
<body> 

<audio id="clip1” title="This is Clip 1” .../> 

<audio id="clip2” title="This is Clip 2” .../> 


</body> 


When you group clips within a <seq>, <par>, or <excl> tag, the clip titles are 
ignored. You should therefore add title, author, and copyright information to 
the group tag, as shown in the following example: 
<body> 
<seq title="This is Sequence 1”> 
<audio id="clip1” .../> 
<audio id="clip2” .../> 


</seq> 
</body> 
As these examples illustrate, the use of <seq> and <par> tags affects whether 
group or clip information displays in RealOne Player. This, in turn, affects 


whether viewers can select parts of the SMIL presentation through clip or 
group listings in the “Now Playing” list: 
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+ If all of your clips and groups are contained within a single <seq>, <par>, or 
<excl> group, no individual clip or group titles display in the “Now 
Playing” list, and viewers cannot select portions of the presentation 


through that list. 


- If no single <seq>, <par>, or <excl> group encloses all other clips or groups, 
individual clip and group titles display in the “Now Playing” list according 
to the order in which the clips and groups are listed in the SMIL file. 


Defining Information for the SMIL Presentation 


Whereas clip source tags and group tags can define information about each 
clip or group, the SMIL file header can use <meta/> tags to define 
information, such as title, author, and copyright, for the entire presentation. 
Each <meta/> tag uses two attributes, name and content, as shown in the 
following example, which defines title, author, and copyright information: 
<head> 

<meta name="title" content="Bob and Susan Discuss Streaming Media"/> 

<meta name="author" content="RealNetworks Media Productions"/> 


<meta name="copyright" content="(c)2001 RealNetworks"/> 
</head> 


Tip: Name values, as in name=“title”, must be lowercase. When 
defining long content such as an abstract, don’t use line breaks 
or tabs within a content value. 


The presentation information displays in the following areas of RealOne 
Player: 


+ Title, author, and copyright information for a presentation crawls 
horizontally along the title bar at the top of RealOne Player. 


- Presentation title and author information appears in the “Now Playing” 
list, which is part of the RealOne Player media browser pane. For an 
example of this list, see the figure “RealOne Player ‘Now Playing’ List” on 
page 37. 


+ Presentation title, author, and copyright information displays when the 
viewer gives the View>Clip>Clip Info command, as illustrated in the 
following figure. 
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Presentation Information 


Clip :Presentation: File 


Title: Bob and Susan Discuss Streaming Media 
Author: RealNetworks Media Productions 
Copyright: (c)2001 RealNetworks 


Example of Presentation and Clip Information 


The following SMIL example defines both presentation and clip information: 
<smil xmlns=“http://www.w3.org/2001/SMIL20/Language”> 
<head> 
<meta name="title" content="Bob and Susan Discuss Streaming Media"/> 
<meta name="author" content="RealNetworks Media Productions"/> 


<meta name="copyright" content="(c)2001 RealNetworks"/> 

</head> 

<body> 
<video src="clip1.rm" title="Bob Expounds His View"/> 
<video src="clip2.rm" title="Susan Responds with Another Perspective"/> 
<video src="clip3.rm" title="Summary: A Look at the Future"/> 

</body> 

</smil> 


Because the sequence of video clips does not use a <seq> tag, the individual 
clip titles display in the “Now Playing” list, indented below the presentation 
title, as shown in the figure “RealOne Player ‘Now Playing’ List” on page 37. 


Adding Accessibility Information 


Although the clip, group, and presentation information attributes always 
display in RealOne Player, the accessibility attributes function only with 
assistive reading devices used by visually impaired viewers. The following table 
summarizes the attributes that help make your presentation accessible to all 
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viewers. RealNetworks encourages you to add these attributes to your 


presentation. 
Accessibility Attributes 
Attribute Value Function Reference 
alt text Provides alternate text. page 242 
longdesc | text Gives a long description to assistive reading devices. | page 242 
readIndex | integer | Sets the order in which clip information is read. page 243 


Including an Alternate Clip Description 


Each clip source tag can include an alt attribute that uses short, descriptive 
text as its value. This alt value displays in RealOne Player when the viewer 
moves the screen pointer over the clip. It is good practice always to include an 
alt attribute for each clip. In the following example, the text “Introductory 
Video” displays when the viewer moves the screen pointer over the clip: 


<video src="videol.rm” alt="Introductory Video” /> 


Note: Unlike browsers that display image alt text before the 
images are downloaded, RealOne Player does not display alt 
text for clips before they play. 


Tip: If the clip includes hyperlinks, the link’s alt value or URL 
displays in place of the clip’s alt text. For more on alt in 
hyperlinks, see “Displaying Alternate Link Text” on page 370. 


Using a Long Description 


Each source tag can include a longdesc attribute that supplements the alt 
attribute. Some assistive-reading devices can read this long description for 
visually-impaired viewers. If you turn the clip into a hyperlink as described in 
Chapter 15, the description should describe the link destination. Here is an 
example: 


<img src="button3.gif” longdesc="This is the third navigation button. Clicking it 
opens your browser to the home page for RealNetworks.” .../> 
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Setting the Clip Read Order 


When a visually-impaired viewer uses an assistive-reading device, the device 
typically reads the values of the title, alt, and longdesc attributes in each clip 
source tag. When clips play in parallel, the device reads the attributes in the 
order that the clip tags appear in the <par> group. To change this order, you 
can add readIndex attributes to the clip source tag. Each readIndex attribute, 
which has a default value of 0, takes a positive integer as a value. Here is an 
example: 
<par> 
<img ... alt="Link Button 1” longdesc="Start next video” readIndex="1”" /> 
<img ... alt="Link Button 2” longdesc="Visit home page” readIndex=" 2" /> 
<video ... alt="Presentation Video” readIndex="0"/> 
</par> 


In the example above, the video source tag has the lowest readIndex value, so 
an assistive device reads that clip’s alt attribute information first. Next, the 
device reads the first image’s alt and longdesc attributes, followed by the 
second image’s alt and longdesc attributes. 


Note: If two or more source tags have the same readIndex value, 
clip information is read according to the order that the clip 
source tags appear in the markup. 


For More Information: The section “Playing Clips in Parallel” on 
page 249 describes parallel groups. 
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GROUPS 


CHAPTER 


11 


Grouping clips is the fundamental way to organize a presentation 


timeline. For example, you can play clips one after another, or 


display several clips at the same time. This chapter describes how to 


use the basic group tags to organize a presentation. Once you 


understand how groups work, you can use the timing commands 


described in later chapters to modify group behavior. 


Understanding Groups 


Within a SMIL presentation, you can organize clips into three types of groups. 


The presentation can have any number of these groups: 


sequences 


In a sequence, clips play one at a time, one after the other. When one clip 
stops, the next clip begins, and so on until the sequence finishes. In SMIL, 
a <seq> tag indicates the start of a sequence. A corresponding </seq> tag 
denotes the end of the sequence. The section “Playing Clips in Sequence” 
on page 247 explains sequences. 


parallel groups 


In a parallel group, all clips play together. For example, a parallel group 
could include a video and a RealText clip that provides subtitles. When 
you create a parallel group, you need to define a layout that specifies 
where each clip appears onscreen. A <par> tag starts a parallel group, anda 
</par> tag ends the group. See the section “Playing Clips in Parallel” on 
page 249 for more information. 


exclusive groups 


In an exclusive group, only one clip plays at a time. This type of group is 
typically created for interactive presentations. For example, a presentation 
may include several buttons, each of which selects a different video. 
Depending on which button the viewer clicks, a different clip from the 
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group is selected. An exclusive group is created between <excl> and </excl> 
tags. The section “Creating an Exclusive Group” on page 259 explains 
exclusive groups. 


Groups Within Groups 


One of the powerful features of SMIL is the ability to nest groups within 
groups. For example, you can combine <seq> and <par> tags in various ways to 
create many types of presentations. The organization of these tags greatly 
affects playback, though, and you need to be careful when creating deeply 
nested groups. In the following example, clip 1 plays first. When it finishes, 
clip 2 and clip 3 play together. When both clip 2 and clip 3 have finished 
playing, clip 4 plays: 
<seq> 
clip 1 
<par> 
clip 2 
clip 3 
</par> 
clip 4 
</seq> 


You get very different results, though, if you switch the <seq> and <par> 
groupings. In the next example, clips 1, 2, and 4 all begin at the same time. 
When clip 2 finishes, clip 3 starts: 
<par> 
clip 1 
<seq> 
clip 2 
clip 3 
</seq> 
clip 4 
</par> 


The following illustration shows the difference between these groupings. 
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Different Playback Results with Nested Groups 


5 Example 1 
> 
1 —xr 4 —“qO 
3 Timeline 
Example 2 


Playing Clips in Sequence 


A sequence is the simplest type of group to create. Just list the clips within 
<seq> and </seq> tags in the order that you want them to play. The following 
example shows the entire SMIL markup required to play three audio clips in 
sequence: 
<smil xmlns=“http://www.w3.org/2001/SMIL20/Language”> 
<body> 
<seq> 
<audio src="song1.rm” /> 
<audio src="song2.rm” /> 
<audio src="song3.rm” /> 
</seq> 
</body> 
</smil> 


In the preceding example, the second clip begins when the first clip finishes, 
and the third clip begins when the second clip finishes. A sequence can 
include any number of clips, and the clips can be of any type. You could add a 
RealVideo or Flash clip to the sequence shown above, for example. When using 
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visual clips, however, you should also define a layout as described in Chapter 
12. 


When you enclose clips in <seq> and </seq> tags, RealOne Player treats the 
sequence as a single presentation. If each clip in the preceding example is two 
minutes in length, for example, the RealOne Player status bar indicates that 
the presentation is six minutes long. Because RealOne Player treats the 
sequence as a single presentation, viewers can use the timeline slider to seek 
through all the clips, but cannot choose individual clips through the RealOne 
Player Play>Next Clip command. 


Creating Sequences Without Sequence Tags 


It is not always necessary to group clips within <seq> and </seq> tags. 
Whenever clips are not listed in a group, RealOne Player automatically plays 
them in sequence. For instance, the following markup, which has no <seq> and 
</seq> tags, plays three audio clips in sequence just like the preceding example: 
<smil xmlns=“http://www.w3.org/2001/SMIL20/Language”> 
<body> 
<audio src="song1.rm”/> 
<audio src="song2.rm”/> 
<audio src="song3.rm”/> 
</body> 
</smil> 


When you do not use a <seq> group, however, RealOne Player treats each clip 
as a separate presentation. Suppose that each clip in the preceding example 
lasts two minutes. When the sequence starts, the RealOne Player status bar 
indicates that the presentation lasts two minutes. When the first clip ends, 
RealOne Player’s timeline slider resets, the second clip starts, and the status 
bar indicates another two-minute presentation. This action repeats when the 
third clip plays. At any point, the viewer can select a different clip with the 
RealOne Player Play>Next Clip command. 


Tips for Creating Sequences 


- A<seq> tag can include a title, author, copyright, or abstract attribute just 
like a clip source tag. For more information, see “Adding Clip and Group 
Information” on page 238. 
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- A sequence and each clip within a sequence can use a begin attribute to 
delay playback. For more information, see “Setting Begin and End Times” 
on page 314. 


- A sequence and each clip within a sequence can use a dur attribute to 
control the total playing time. For more information, see “Setting 
Durations” on page 317. 


+ You can use the repeatDur and repeatCount attributes to repeat a sequence 
or aclip within a sequence. See “Repeating an Element” on page 323 for 
more information. 


- Because clip source tags as well as the <seq> tag can have timing attributes, 
it is easier to set all necessary timing attributes in the clip source tags first, 
so that they operate as you want them to within the sequence. Then, after 
determining how long the sequence will last, use timing attributes within 
the <seq> tag to modify the group behavior if necessary. 


Playing Clips in Parallel 


You can play two or more clips at the same time by grouping the clip source 
tags between <par> and </par> tags. The following example creates a parallel 
group that combines a RealVideo clip with a RealText clip: 
<smil xmlns=“http://www.w3.org/2001/SMIL20/Language”> 
<head> 
<layout> 
...region layout defined as described in Chapter 12... 
</layout> 
<body> 
<par> 
<video src="song.rm” region="region1_ID” /> 
<textstream src="Lyrics.rt” region="region2_ID” /> 


</par> 
</body> 
</smil> 


In the preceding example, the RealVideo and the RealText clips play at the 
same time. A parallel group can include any number of clips, but you need to 
define a playback region for each visual clip as described in Chapter 12. (Audio 
clips do not need to play in regions.) Each region defined in the layout must 
have a unique id="ID" attribute. You then assign each clip to a region with a 
region=“ID" attribute in the clip source tag. 
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Tips for Creating Parallel Groups 


+ When you create parallel groups, you need to be careful that clips playing 
at the same time do not exceed the audience connection’s maximum 
bandwidth, which is described in “Audience Bandwidth Targets” on page 
47. If the maximum streaming bandwidth is 34 Kbps, for example, do not 
have two clips that each stream 20 Kbps of data play in parallel. 


+ When a parallel group contains a still image, RealOne Player does not play 
the group until it has received all of the image data. If you set too low of a 
streaming speed for an image, therefore, you may delay group playback. 
See “Setting a Clip’s Streaming Speed” on page 210 for more information. 


- A<par> tag can include a title, author, copyright, or abstract attribute just 
like a clip source tag. For more information, see “Adding Clip and Group 
Information” on page 238. 


- A parallel group normally lasts as long as the longest clip in the group. 
However, you can modify this with the endsync attribute, as described in 
“Ending a Group on a Specific Clip” on page 320. 


- A parallel group and each clip within the group can use a begin attribute 
to delay playback. For more information, see “Setting Begin and End 
Times” on page 314. 


- A parallel group and each clip within the group can use a dur attribute to 
control the total playing time. For more information, see “Setting 
Durations” on page 317. 


- You can use the repeatDur and repeatCount attributes to repeat a parallel 
group. See “Repeating an Element” on page 323 for more information. 


- By using readindex attributes, you can change the order that assistive 
reading devices read attributes of clips in parallel groups. See “Setting the 
Clip Read Order” on page 243 for more information. 


Synchronizing Playback in Parallel Groups 


Under normal circumstances, Helix Universal Server keeps clips within a 
parallel group synchronized, as long as you have authored your presentation 
so that its timeline runs smoothly, and it doesn’t consume more bandwidth 
than its target audience has available. The following table summarizes the 
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optional attributes you can add to elements within parallel groups to modify 
playback behavior, especially under adverse conditions. 


Parallel Group Synchronization Attributes 


Attribute Value Function Reference 


syncBehavior | canSlip|default| Determines if clips can fall out | page 251 
independent|locked | of synchronization. 


syncBehavior | canSlip|independent| | Sets default synchronization page 255 


Default inherit|locked for a group. 

syncTolerance | default|time_value Loosens synchronization for page 257 
locked elements. 

syncTolerance | default|time_value Sets a default synchronization | page 257 

Default tolerance for a group. 


Creating an Independent Timeline 


Adding syncBehavior=“independent” to a clip in a parallel group keeps the clip 
completely unsynchronized from other clips in the group. In fact, the clip acts 
like a live broadcast. Moving the RealOne Player timeline slider does not fast- 
forward or rewind the clip. In the following parallel group, the RealText clip 
has an independent synchronization behavior. It begins to play along with the 
RealAudio and Flash clips, but if the viewer fast-forwards or rewinds the 
presentation, only the RealAudio and Flash clips are affected: 
<par> 

<audio src="soundtrack.rm” .../> 

<ref src="training.swf” .../> 

<textstream src="translation.rt” syncBehavior=“independent” .../> 
</par> 


Note that a parallel group’s overall timing still applies to a clip that uses 
syncBehavior="independent”. In the following example, the parallel group plays 
first, lasting for five minutes because of the dur attribute in the <par> tag. A 
video then follows the group in sequence. If the viewer moves the timeline 
slider to the five-minute mark, for instance, all clips in the parallel group end, 
and the video plays. So even if it lasts 10 minutes, the RealText clip ends when 
the group ends, regardless of its syncBehavior="independent value: 
<body> 

<seq> 

<par dur="5min"> 
<audio src="soundtrack.rm” .../> 
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<ref src="training.swf” .../> 
<textstream src="translation.rt” syncBehavior=“independent” .../> 
</par> 
<video src="conclusion.rm” .../> 
</seq> 
</body> 
The independent value is the only syncBehavior value that has a visible effect on 
how a parallel group plays under normal circumstances. As described in the 
following sections, the other syncBehavior values affect clips in a parallel group 
only under difficult streaming conditions. 


Setting the Synchronization Behavior 


RealOne Player generally compensates well for changing network conditions 
to keep a presentation streaming smoothly. Under highly adverse conditions, 
though, it may have to suspend playback of a group until more data arrives. 
With the syncBehavior attribute, you can influence how RealOne Player 
handles these situations. Think of these attributes as defensive measures: they 
don’t affect how your presentation plays under normal circumstances, just 
how it handles adverse situations. The following table describes the attribute 


values. 
syncBehavior Attribute Values 
Value Function 
canSlip RealOne Player can suspend playing this clip as long as necessary until 
more clip data arrives. It then fast-forwards the clip so that it catches 
up with the group timeline. Other clips continue playing without 
regard to the state of this clip. 
locked The clip must stay synchronized with the group. If the clip’s data 


stream stops, RealOne Player halts the group playback until new clip 
data arrives. You can also add a tolerance value, as described in 
“Loosening the Synchronization for Locked Elements” on page 257. 


independent | Clip playback is entirely independent of group playback. See “Creating 
an Independent Timeline” on page 251. 


default The clip behavior is controlled by the group tag’s syncBehaviorDefault 
attribute, as described in “Specifying Synchronization Behavior 
Default Values” on page 255. You do not need to set this value 
explicitly if you also set a syncBehaviorDefault value because clips 
will inherit the default value automatically. 
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Note: If you do not set any syncBehavior values, elements behave 
as if they are set to the canSlip value. 


Synchronizing Clips 

In most cases, you'll want to use a combination of canSlip and locked as the 
syncBehavior value for clips within parallel groups. Consider the following 
example, in which a Flash clip, a RealAudio clip, and a RealText clip play in 
parallel. This example could be a training movie in which the Flash animation 
displays visual information, the RealAudio clip provides an audio narration, 
and the RealText clip supplies translated audio subtitles: 
<par> 

<audio src="soundtrack.rm” syncBehavior=“locked” .../> 

<ref src="training.swf” syncBehavior=“canSlip” .../> 

<textstream src="translation.rt” syncBehavior=“locked” .../> 
</par> 


The Flash clip in the preceding example can slip, meaning that RealOne Player 
will suspend playback for this clip first if bandwidth drops too low. RealOne 
Player will resume playing the clip when more bandwidth is available. At that 
point, it will fast-forward the Flash clip to bring it into synchronization with 
the RealAudio and RealText clips. The viewer will notice that the Flash clip has 
paused, but the audio and the subtitles will continue to play as long as 
conditions do not get too bad. 


The RealAudio soundtrack and the RealText subtitles in the preceding 
example are locked with the group. This means that RealOne Player does 
everything it can to keep these clips synchronized and flowing smoothly. As 
described above, RealOne Player’s first suspends the Flash clip if necessary. If 
that action does not provide enough bandwidth, and the RealAudio stream 
also runs dry, RealOne Player halts the entire group until it has received 
enough data to continue playing the RealAudio and the RealText clips. It 
brings the Flash clip up to the group’s current position whenever conditions 
allow. 


Synchronizing Groups 


Just as you can synchronize clips within groups, you can also synchronize 
groups within groups. Suppose that the preceding example is modified so 
that it plays a sequence of RealAudio clips, rather than just one clip, in parallel 
with the Flash and RealText clips: 
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<par> 
<seq syncBehavior=“locked”> 
<audio src="soundtrack1.rm” .../> 
<audio src="soundtrack2.rm” .../> 
<audio src="soundtrack3.rm” .../> 
</seq> 
<ref src="training.swf” syncBehavior=“canSlip” .../> 
<textstream src="translation.rt” syncBehavior=“locked” .../> 
</par> 


In the preceding example, the syncBehavior attribute is used in the <seq> tag to 
lock the entire sequence of RealAudio clips with the parallel group. Because of 
group nesting, synchronization can become complex, as shown in the 
following abstract example: 
<par id="master_group”> 
<ref id="clip_A” syncBehavior="Locked” .../> 
<par id="group_X” synchBehavior="Llocked” .../> 
<ref id="clip_B” synchBehavior="Locked” .../> 
<ref id="clip_C” synchBehavior="canSlip” .../> 
</par> 
<par id="group_Y” syncBehavior="canSlip”> 
<ref id="clip_D” synchBehavior="Locked” .../> 
<ref id="clip_E” synchBehavior="Locked” .../> 
</par> 
</par> 
To understand how this hypothetical grouping works, look at the outer <par> 
group first. You can see that this group contains three elements: clip_A, 
group_X, and group_Y. The syncBehavior attributes on these elements determine 
the presentation’s overall synchronization. Because clip_A and group_X are 
locked, RealOne Player ensures that these elements stay synchronized. Under 
adverse conditions, it first halts playback of group_Y if necessary. 


Within group_X, clip_B is locked. Hence, clip_B will continue to play in step 
with clip_A unless network conditions greatly deteriorate. Because clip_C can 
slip, RealOne Player’s second line of defense is to halt playback for clip_C while 
keeping clip_A and clip_B playing. When network conditions improve, RealOne 
Player first restores clip_C, then group_Y to the presentation. Note, however 
that both clip_D and clip_E are locked in group_Y. This means that RealOne 
Player won’t restore group_Y until it can play both clips. 
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Specifying Synchronization Behavior Default Values 


The group attribute syncBehaviorDefault is useful for setting synchronization 
behaviors with groups that contain many clips, or with nested groups. In a 
group tag, the syncBehaviorDefault attribute determines which synchronization 
behavior is used if a group element does not specify a syncBehavior value, or 
uses syncBehavior="default”. In the following example, the group tag has a 
locked synchronization behavior set by default: 
<par syncBehaviorDefault=“locked”> 

<audio src="soundtrack.rm” .../> 

<ref src="training.swf” syncBehavior=“canSlip” .../> 

<textstream src="translation.rt” syncBehavior="default” .../> 
</par> 


In the preceding example, the RealAudio clip does not specify a syncBehavior 
attribute, and the RealText clip uses syncBehavior=“default”. Both clips 
therefore use the default value (locked) set in the group tag. The Flash clip 
specifies a different synchronization behavior, though, which overrides the 
default setting. 


Setting Groups to Inherit Synchronization Defaults 


A group tag’s syncBehaviorDefault attribute can have the values locked, canSlip, 
or independent, which are described in the table “syncBehavior Attribute 
Values” on page 252. The attribute’s default value is inherit, which you can also 
set explicitly in a group tag. This inherit value is useful with nested groups, as 
shown in the following abstract example: 


<par id="master_group” syncBehaviorDefault="canSlip”> 
<par id="group_X” syncBehaviorDefault="inherit”> 
...group_X clips played in parallel... 
</par> 
<par id="group_Y”> 
...group_Y clips played in parallel... 
</par> 
<par id="group_Z” syncBehaviorDefault="locked”> 
...group_Z clips played in parallel... 
</par> 
</par> 


In this example, group_X and group_Y both inherit the master group’s 
syncBehaviorDefault value of canSlip. Elements within these two groups will use 
the canSlip behavior unless another value is specified in their tags. On the 
other hand, group_Z overrides the master group’s behavior and sets a default of 
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locked. Elements within group_z will use the locked behavior unless they 
explicitly specify a different value. 


Nested Group Interactions with Synchronization Behaviors 


When you have several levels of nested groups that use syncBehavior and 
syncBehaviorDefault, it’s important to understand how the groups and their 
elements interact. Because elements inherit a syncBehaviorDefault value by 
default, the interactions can be difficult to grasp unless you look at all levels 
of the nested groups. Consider the following abstract example: 
<par id="master_group” syncBehaviorDefault="canSlip”> 
<par id="group_X” syncBehaviorDefault="inherit”> 
<ref id="clip_A” .../> 
<ref id="clip_B” syncBehavior="locked” .../> 
</par> 
<par id="group_Y” syncBehavior="locked”> 
<ref id="clip_C” .../> 
<ref id="clip_D” .../> 
</par> 
<par id="group_Z” syncBehaviorDefault="locked”> 
<ref id="clip_E” .../> 
<ref id="clip_F” syncBehavior="canSlip” .../> 
</par> 
</par> 


The master group sets a syncBehaviorDefault value of canSlip. The elements 
within this master group have the following syncBehavior values: 


* group_X set to canSlip 


group_X inherits the default value of canSlip from master_group, and passes 
that value to the clips it contains, one of which overrides the value: 


¢ clip_A set to canSlip 
- clip_B set to locked 
* group_Y set to locked 


group_Y sets its own behavior to locked. However, it inherits the default 
value of canSlip from master_group, and passes that value to both clips it 
contains: 


* clip_C set to canSlip 
¢ clip_D set to canSlip 


* group_Z set to canSlip 
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group_Z inherits the default value of canSlip from master_group. However, it 
changes the default value for the elements it contains to locked. One of the 
clips overrides that value: 


- clip_E set to locked 


¢ clip_F set to canSlip 


Loosening the Synchronization for Locked Elements 


When you add syncBehavior=“locked” to elements within a group, RealOne 
Player keeps those elements, whether clips or groups, tightly synchronized. 
You can loosen the synchronization by adding syncTolerance=“time_value” to 
the containing group. A tolerance value is useful if the elements do not need 
to be highly synchronized: the higher the tolerance, the less likely that 
RealOne Player will have to halt the entire group to rebuffer data. The 
following example adds a three-second tolerance to the locked elements: 
<par syncTolerance=“3s"> 

<audio src="soundtrack.rm” syncBehavior="Locked” .../> 

<ref src="training.swf” syncBehavior=“canSlip” .../> 

<textstream src="translation.rt” syncBehavior=“Llocked” .../> 
</par> 


In the preceding example, the locked RealAudio and RealText clips can fall at 
least three seconds out of synchronization before RealOne Player stops the 
group to rebuffer the data streams. Base the amount of time to set for a 
tolerance on your judgment of how far the clips can fall out of 
synchronization without the group playback becoming too confusing for the 
viewer. 


For More Information: SMIL timing values are described in 
“Specifying Time Values” on page 313. 
Specifying Synchronization Tolerance Default Values 


Similar to syncBehaviorDefault, the group attribute syncToleranceDefault can set 
synchronization tolerances for nested groups. In the following example, the 
master containing group sets a syncToleranceDefault value of three seconds: 
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<par id="master_group” syncTolerance="4s” syncToleranceDefault=“3s”"> 
<par id="group_X” syncBehavior="locked” syncTolerance="inherit”> 
...group_X clips played in parallel... 
</par> 
<par id="group_Y” syncBehavior="canSlip”> 
...group_Y clips played in parallel... 
</par> 
<par id="group_Z” syncBehavior="canSlip” syncTolerance="5s"> 
...group_Y clips played in parallel... 
</par> 
</par> 


In the preceding example, group_X includes syncTolerance="inherit” and group_Y 
does not have a syncTolerance value. Both groups therefore inherit the master 
group’s tolerance value of three seconds. However, group_Z sets its own 
tolerance value of five seconds, which overrides the master group’s default. 


Note that the master group has both a syncTolerance and a syncToleranceDefault 
value. When you use synchronization tolerance values, it’s important to keep 
in mind what these values do: 


« The syncTolerance value determines the tolerance value used for elements 
within the group. In the preceding example, the syncTolerance value for the 
master group affects the tolerance applied to group_X, group_Y, and 
group_Z, but not to the elements within those groups. 


- The master group’s syncToleranceDefault value sets the tolerance on each 
subgroup’s elements, as long as group_X, group_Y , or group_Z inherits the 
value and does not override it with its own tolerance value. 


Tips for Synchronizing Clips 


- Authoring a presentation so that it does not consume too much 
bandwidth is the best defense against network uncertainties. Make sure 
that you understand timeline and bandwidth issues as described in 
“Chapter 2: Presentation Planning” beginning on page 27. 


+ Within a parallel group, it’s best to use a locked synchronization on the 
clip that provides the audio. Viewers are more likely to stay tuned to a 
presentation in which visuals stop and start if the audio continues to flow 
smoothly. 


+ If you use a locked synchronization on all clips in a group, it’s a good idea 
to set a tolerance of a few seconds. This helps RealOne Player to prevent 


258 


CHAPTER 11: Groups 


the entire presentation from halting if data for just one clip is slow to 
arrive. 


Creating an Exclusive Group 


The <excl> and </excl> tags create an exclusive group in which only one 
element plays at a time. In a <seq> group, only one element plays at a time, too, 
but the playback order always proceeds from the first to the last element. In 
contrast, an <excl> group has no predefined playback order. The playback 
order depends wholly on the SMIL timing commands defined for each 
element in the group. 


You use an exclusive group for different purposes than you use a parallel 
group or a sequence. With <par> and <seq> tags, you can construct a single 
timeline that flows continuously throughout the entire presentation. Using 
an exclusive group, though, you can break up a timeline through two features: 
interruption and interactivity. 


As an example of both interruption and interactivity, imagine a group of 
videos in which each video plays only when the viewer clicks an icon for the 
video. This is interactivity. Then, as it plays, a selected video pauses 
intermittently as advertising clips play, automatically resuming when each ad 
clip finishes. This is interruption. An exclusive group may define just one of 
these features, or both. 


Tip: To understand how exclusive groups work, you'll need to 
know about timing attributes. You may therefore want to read 
Chapter 13 and Chapter 14 first. 


Defining Interactive Begin Times 


Adding interactivity to a presentation is a main function of an exclusive 
group. In the following example, an exclusive group of videos plays in parallel 
with three images. All the video clips in the exclusive group use interactive 
begin values to start playback only when the viewer clicks an image. Hence all 
three images appear as soon as the parallel group becomes active, but each 
video does not become visible until an image is clicked: 
<par> 

<img src="number1.gif” id="button1” .../> 

<img src="number2.gif” id="button2” .../> 

<img src="number3.gif” id="button3” .../> 
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<excl dur="indefinite”> 
<video src="video1.rm” begin="button1.activateEvent” .../> 
<video src="video2.rm” begin="button2.activateEvent” .../> 
<video src="video3.rm” begin="button3.activateEvent” .../> 
</excl> 
</par> 


Note that the exclusive group in the preceding example uses dur=“indefinite”, 
which keeps the group active indefinitely. A timing command such as this is 
required because an <excl> has an intrinsic duration of 0 seconds when its 
elements use interactive timing. You therefore need to use timing commands 
in the <excl> tag to control the group’s overall duration. Another option is to 
use endsync="all” to keep the group active only until all of its elements have 


played. 


For More Information: The begin value used to start a clip with a 
mouse click is described in “Defining a Mouse Event” on page 
346. For more on endsync="all”, see “Stopping a Group After 
the Last Clip Plays” on page 320. 


Using Clip Interruption 


The following example demonstrates a simple exclusive group with basic clip 
interruption. As with a <seq> group, only one clip from this <excl> group will 
play at a time. Unlike a <seq> group, though, the order in which you list the 
clips does not matter because the timing attributes completely control 
playback. In the following example, clips play in the reverse order from which 
they are listed: 
<excl> 

<img src="numberl.png” region="images” begin="6s” dur="5s"/> 

<img src="number2.png” region="images” begin="3s” dur="5s"/> 

<img src="number3.png” region="images” begin="0s” dur="5s"/> 
</excl> 


In the preceding example, number3.png plays first. Its begin=“0s” value means 
that it plays as soon as the <excl> group becomes active. Its dur="5s” value 
makes it play for five seconds. The number2.png clip starts playing three 
seconds after the group becomes active, however. Because only one group 
element can play at a time, the begin="3s” value for number2.png overrides the 
dur="5s" value for number3.png. When number2.png starts to play, it stops 
number3.png. Likewise, when number1.png starts, it stops number2.png. 
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For More Information: For more on the begin attribute, see 
“Setting Begin and End Times” on page 314. Durations are 
explained in “Setting Durations” on page 317. 


Modifying Clip Interruption Behavior 


By defining priority classes, you can control how clips in an exclusive group 
interrupt each other. In an exclusive group that does not use priority classes, 
an interrupting clip stops the interrupted clip. By defining priority classes, 
though, you can pause the interrupted clip instead, so that its playback 
resumes once the interrupting clip finishes. You define a priority class with 
<priorityClass> and </priorityClass> tags. Between these tags, you list the media 
clips within that priority class, as shown here: 
<excl> 
<priorityClass...> 
...clips in the higher priority class... 
</priorityClass> 
<priorityClass...> 
...clips in the lower priority class... 
</priorityClass> 
</excl> 


When you create priority classes, the order of clips within the <excl> group 
becomes important. The first priority class has the highest priority, the last 
class has the lowest priority. All clips within a priority class have the same 
priority, and are called peers. 


Once you define priority classes, you can use the attributes summarized in the 
following table to set the interruption behavior for clips in each class. A 

<priorityClass> tag can have an id attribute and any of the following attributes, 
but no others. You cannot include timing attributes in a <priorityClass> tag, for 


example. 
<priorityClass> Attributes 
Attribute Value Default Function Reference 
peers defer|never| |stop | Controls how clips within the same | page 262 
pause|stop class interrupt each other. 
higher pause|stop pause | Determines how clips with higher | page 263 


priority interrupt clips in the class. 
(Table Page 1 of 2) 
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<priorityClass> Attributes (continued) 
Attribute Value Default Function Reference 


lower defer|never |defer | Specifies how interrupting clips page 263 
with lower priority affect playback. 


pauseDisplay | disable|hide| |show | Sets aclip’s appearance if the clip is | page 264 
show paused. 
(Table Page 2 of 2) 


Controlling How Peers Interact 


The peers attribute for a priority class determines how clips within that 
priority class interrupt each other. The peers attribute can have one of the 
values given in the following table. 


peers Attribute Values 


Value Function 


defer | An interrupting clip does not start until the currently playing clip stops. 


never | An interrupting clip does not start at all. 


pause |The interrupting clip pauses the playing clip. After the interrupting 
clip finishes, the paused clip resumes playback. The pauseDisplay 
attribute sets the appearance of the paused clip. 


stop The interrupting clip stops the playing clip. This is the default if you 
leave the peers attribute out of the <priorityClass> tag, or you do not 
define any priority classes within an <excl> group. 


For example, to have clips within an exclusive group pause each other instead 
of stop each other during interruptions, you can define a single priority class 
and use peers=“pause” as shown here: 


<excl> 
<priorityClass peers=“pause”> 
<video src="videol.rm” .../> 
<video src="video2.rm” .../> 
<video src="video3.rm” .../> 
</priorityClass> 
</excl> 


For More Information: For more on pauseDisplay, see “Specifying 
How Paused Clips Display” on page 264. 
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Setting Interactions with Higher Priority Classes 
For priority classes other than the highest priority class, you can use the higher 
attribute in the <priorityClass> tag to determine how any clip in a higher 
priority class interrupts a clip in the current priority class. The higher attribute 
can take one of the values listed in the following table. 


higher Attribute Values 


Value Function 


pause | An interrupting clip from a higher priority class pauses the playing clip. 
After the interrupting clip finishes, the paused clip resumes playback. This 
is the default if you do not use the higher attribute. The pauseDisplay 
attribute sets the appearance of the paused clip. 


stop An interrupting clip from a higher priority class stops the playing clip. 


In the following example, the first priority class (class1) has higher priority. 
The second priority class (class2) uses higher="stop” to specify that if a clip 
from class1 interrupts a clip from class2, the class2 clip will stop. Note, though, 
that class2 also uses peers=“pause”. This means that if a clip from class2 
interrupts another clip from that class, the interrupted clip will pause, not 
stop: 
<excl> 
<priorityClass id="class1”> 
...clips in the higher priority class... 
</priorityClass> 
<priorityClass id="class2” higher="stop” peers=”"pause”> 
...clips in the lower priority class... 
</priorityClass> 
</excl> 


For More Information: For more on pauseDisplay, see “Specifying 
How Paused Clips Display” on page 264. 


Setting Interactions with Lower Priority Classes 


For priority classes other than the lowest priority class, you can use the lower 
attribute in the <priorityClass> tag to determine how a clip from a lower 
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priority class acts if it attempts to interrupt a clip in the current priority class. 
The lower attribute can take one of the values listed in the following table. 


lower Attribute Values 


Value Function 


defer | An interrupting clip from a lower priority class does not start until the end 
of the current clip, as well as any higher-priority clips that play after the 
current clip. This is the default if you do not use the lower attribute. 


never | An interrupting clip from a lower priority class does not play at all. 


In the following example, the first priority class (class1) has higher priority 
and uses lower=“never” to specify that if a clip from class2 attempts to interrupt 
a clip from class1, the class2 clip will not play at all. Note, though, that class2 
also uses peers=“defer”. This means that if a clip from class2 interrupts another 
clip from that class, the interrupting clip will play after the interrupted clip 
finishes: 


<excl> 
<priorityClass id="class1” lower="never”> 
...clips in the higher priority class... 
</priorityClass> 
<priorityClass id="class2” peers="defer”> 
...clips in the lower priority class... 
</priorityClass> 
</excl> 


Specifying How Paused Clips Display 


When you set peers=“pause” or higher=“pause” in a <priorityClass> tag, you can 
also set the pauseDisplay attribute, which determines how a clip appears when 
it pauses. This attribute, which has no effect on audio-only clips, can take one 
of the values listed in the following table. 


pauseDisplay Attribute Values 
Value Function 


disable | The paused clip appears visible but disabled in RealOne Player. It does not 
respond to mouse clicks until it resumes playback. 


hide The paused clip disappears until it resumes playback. 


show The paused clip remains visible in RealOne Player, and it continues to 
respond to mouse clicks. This is the default if you do not use the 
pauseDisplay attribute. 
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In the following example, each clip that interrupts another clip causes that 
clip to pause and disappear. After the interrupting clip finishes playing, the 
interrupted clip reappears and resumes playback: 
<excl> 
<priorityClass peers=“pause” pauseDisplay="hide”> 
<video src="videol.rm” .../> 
<video src="video2.rm” .../> 
<video src="video3.rm” .../> 
</priorityClass> 
</excl> 


Tips for Defining Exclusive Groups and Priority Classes 
- An <excl> group can have one or several priority classes. 


+ Priority classes affect only interruption behavior. They have nothing to do 
with timing. A clip in a lower priority class can play before a clip in a 
higher priority class, or vice versa. 


+ When you use priority classes, every element in the <excl> group must 
belong to a priority class. You cannot mix clips that are within priority 
classes and clips that are outside of priority classes. 


+ Priority classes cannot be nested. That is, one priority class cannot 
contain another priority class. 


- A priority class can contain clips or groups of clips. 
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LAYOUT 


When you stream more than one clip, you use SMIL to lay out the 
presentation. The layout defines where each clip appears in RealOne 
Player. Clips might appear side by side, for example, or stacked on 
top of each other. You can even play clips in windows that pop up 
from the RealOne Player main media playback pane. 


Note: For instructions on laying out a presentation in a Web 
page instead of in RealOne Player, see Chapter 20. 


Understanding Layouts 


If your presentation is audio-only, or it displays just one clip, you do not need 
to create a layout. However, if you want to play successive clips in the same 
area, or if your presentation displays multiple clips together, you need to 
define a layout. The following sections provide an overview of the main layout 
features. 


Root-Layout Area 


You define a presentation’s layout in a SMIL file’s header section. You first 
create one (and only one) root-layout area, which sets the size of the main media 
playback pane when the presentation starts. This size stays constant 
throughout the presentation unless the viewer manually resizes the pane, or 
you change the root-layout size using a SMIL animation. You cannot play any 
clips in the root-layout area, but you can set its color. 


For More Information: The section “Defining the Main Media 
Playback Pane” on page 276 explains how to set up the root- 
layout area. 
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Playback Regions 


Each clip plays in a rectangular region. Within the main media playback pane, 
all regions lay within the root-layout area. You might define just one region 
that’s the same size as the root-layout area, or you might set up multiple 
regions. Although similar to HTML frames, SMIL regions can overlap, letting 
you play a clip in one region in front of a background image in another region, 
for example. 


SMIL Region Possibilities 


| 


For More Information: See “Defining Playback Regions” on page 
279 for information about setting up regions. 


Subregions 


Within each region you can also create subregions, which fall within their 
containing region, just as a region within the main media playback pane falls 
within the root-layout area. A subregion automatically moves if its containing 
region’s position changes. Using a subregion, for example, you can mimic a 
television channel in which a small, partially transparent channel logo appears 
in a corner, hovering above the content. 
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A Subregion Within a Region 


x WD 


|" 


Subregion 


For More Information: See “Defining Subregions” on page 292 
for more information on subregions. 


Secondary Media Playback Windows 


Popping up above the main media playback pane, a secondary media window can 
be moved, resized, and closed independently. You can use a secondary media 
playback window to display RealText credits for a video playing in the main 
media playback pane, for example. As with the main media playback pane, you 
can divide a secondary media playback window into separate playback regions. 
A secondary media playback window can open when the presentation starts, 
or when a certain clip starts to play. All clips playing in the main media 
playback pane and the secondary media playback windows are part of the 
same timeline defined within a single SMIL file. 
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Secondary Pop-Up Window 


Secondary Pop-up Windows Versus Hyperlinked Pop-up Windows 


To open a new window based on viewer input, you create hypertext links to 


other SMIL files in your presentation. When the viewer clicks a hypertext link, 


RealOne Player launches a new, linked window (rather than a secondary media 


playback window) that plays a new SMIL presentation and either stops or 


pauses the clips in the main media playback pane. The following table 


describes the differences between using a secondary pop-up window and a 


hyperlinked pop-up window. 


Secondary Pop-up Windows Versus Hyperlinked Pop-up Windows 


When does the 
window pop up? 


Do clips in the 
main media 
playback pane 


continue to play? 


Secondary Pop-up Window 


The window pops up at the 
beginning of the presentation or 
when the first clip assigned to 
the window begins to play. 


All clips continue to play in the 
main media playback pane and 
the pop-up window according to 
the SMIL timeline. 


Hyperlinked Pop-up Window 


The window pops up when the 
viewer clicks a hyperlink in the 
SMIL presentation. 


You can choose whether to 
continue, pause, or stop the 
presentation in the main 


media playback pane. 


How many SMIL 
files do I write? 


You write just one SMIL file that 
controls the timeline for the 
main media playback pane and 
all secondary media playback 


windows. 


You write separate SMIL files 
for the main media playback 
pane and each hyperlinked 
pop-up window. 


(Table Page 1 of 2) 
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Secondary Pop-up Windows Versus Hyperlinked Pop-up Windows (continued) 


What user 
controls does the 
pop-up window 
have? 


Secondary Pop-up Window 


The pop-up window has buttons 
to minimize, maximize and close 
the window. All timeline and 
menu controls are on the main 


media playback pane. 


Hyperlinked Pop-up Window 


The pop-up window gives the 
viewer many playback controls 
and menus. 


Can the pop-up 
window launch 
another pop-up 
window? 


No, a secondary media playback 
window cannot launch another 
secondary media playback 
window. The main media 
playback pane can launch any 
number of secondary media 


playback windows, though. 


Yes, a hyperlinked pop-up 
window runs a new SMIL 
presentation that can launch 
new windows. 


(Table Page 2 of 2) 


For More Information: Chapter 15 explains hyperlinking. 


Clip Position and Fit 


By default, a clip aligns with a region’s upper-left corner and displays at its 


normal size. If it’s too big for the region, it’s cropped. If it’s too small, the 


region’s background color displays in the remainder of the region. You can 
modify this behavior to align a clip to different points within a region (clip 
position), as well as resize the clip to make it fit the region (clip fit) better. 


Clip Position 


To define clip position, you create various registration points that specify where 


and how clips align to regions. One registration point might center clips in 


their regions, for example. Another point might align clips with their regions 


5 


bottom-left corners. The following figure illustrates two registration points, 


showing a few of the many ways to align clips to a point. 
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Registration Point Alignment 


Registration Point Registration Point 


[A 
[RA 
an | oe 


For More Information: The section “Positioning Clips in 
Regions” on page 295 explains how to specify clip positions. 


Clip Fit 
The clip fit determines what happens when a clip is larger or smaller than its 


region. When a clip does not fit a region, you can keep the clip its normal size, 
scale the clip larger or smaller, or even add scroll bars to handle large clips. 


For More Information: The section “Fitting Clips to Regions” on 
page 301 explains how to control clip fit. 


Tips for Laying Out Presentations 


SMIL provides many options for laying out presentations. In many cases, you 
can achieve the same visual layout by different methods, but some methods 
may provide more clip placement options, for example, or create a layout 
that’s easier to modify. Before you lay out a presentation, make sure you 
understand the options available to you. The following sections will help you 
make choices based on the type of presentation you want to create. 


Tip: It may help to sketch the layout on paper or with 
illustration software. In your sketch, position the regions, 
subregions, and clips, noting their sizes and the thickness of 
any borders that should appear around them. 
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How big should | make the root-layout area? 


Unless the viewer manually resizes the main media playback pane, it stays at 
the root-layout size for the duration of the presentation. Therefore, you need 
to make sure that the root-layout area is large enough to encompass all clips 
you plan to play. Calculate the root-layout size based on the sizes of clips that 
play together, as well as any borders you want to add. 


Root-Layout Example 

Suppose you plan to display two clips, one 100 pixels wide and the other 200 
pixels wide, side-by-side. If you want a five-pixel border around the clips, for 
example, the root-layout area needs to be 315 pixels wide: 


- 5 pixels from the left edge of the root-layout area to the first clip. 
+ 100 pixels for the first clip. 


- 5 pixels from the right edge of the first clip to the left edge of the second 
clip. 


+ 200 pixels for the second clip. 
- 5 pixels from the right edge of the second clip to the right edge of the 


root-layout area. 


RealOne Player Menus and Controls 

When choosing a root-layout size, keep in mind that the RealOne Player 
menus and controls will appear around the main media playback pane. If you 
define a very large root-layout area, some parts of the main media playback 
pane, or some RealOne Player controls, may not appear on the viewer’s screen. 
The smallest computer screen in general use is 640 pixels wide by 480 pixels 


high. 


Double-Screen and Full-Screen Modes 

As described in “Controlling How a Presentation Initially Displays” on page 
514, you can make the presentation display at double-size or full-screen mode 
when it starts up. Doing this may affect how you define the root-layout area. 
For example, most computer screens have a width-to-height ratio of 4:3. 
Therefore, a root-layout area that also has a 4:3 ratio will scale best in full- 
screen mode. 


Should my presentation use secondary media playback windows? 


A secondary pop-up window is a useful way to provide additional information 
in a presentation. You might use the window to provide hypertext links to 
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other streaming presentations or Web pages, for example. A secondary media 
playback window also provides a way to work additional clips into your 
presentation without making the root-layout area too big. 


Add secondary media playback windows with caution, though. Using too 
many secondary media playback windows may make the presentation 
cluttered and difficult for the viewer to follow. Keep in mind, too, that the 
viewer can close secondary media playback windows at any time. Once closed, 
these windows do not open again unless another clip is scheduled to play in 
them later, or the viewer replays the presentation. For this reason, you may not 
want to play crucial clips in secondary media playback windows. 


Tip: As with the root-layout area, calculate a secondary media 
playback window’s height and width based on the sizes of clips 
that play together in the window, as well as any borders you 
want to add. 


How many regions should | create? 


Every visual clip must be assigned to a region, but you don’t necessarily have 
to create a separate region for each clip. When you play a sequence of clips, for 
example, you can assign each new clip to the same region, using registration 
points if necessary to align each clip to the region. When multiple clips play in 
parallel, though, RealNetworks recommends that you define a separate region 
(either a main region or a subregion) for each clip. 


Should | define subregions? 


Any layout that uses subregions can be duplicated using just main regions. 
But using subregions simplifies certain layout tasks because subregions are 
associated with their containing regions. For example, if you move a region 10 
pixels to the left in the root-layout area, all of its subregions automatically 
move with it. If the subregions were main regions instead, you’d have to 
change their layout attributes individually to keep them at the same relative 
position within the larger region. 


Should | create registration points? 


If your regions and subregions are the same sizes as the clips that play in 
them, you do not need to create registration points. You may want to create 
registration points if regions are larger than clips, however and you don’t want 
clips to align with the regions’ upper-left corners. 
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Can | use subregions instead of registration points to position clips? 


Yes. Suppose you want to position a small clip somewhere within a large 
region. You could either apply a registration point to the region, or you could 
create a subregion inside the region. 


When to Use a Registration Point 

The primary advantage of defining a registration point is that you can easily 
apply the point to multiple regions. To center several clips in several different 
regions, it’s much easier to define a single registration point and apply it to 
the various regions than to create a subregion for each clip. 


When to Use a Subregion 

Defining a subregion for a smaller clip gives you more options in determining 
how the clip appears within the region. You can set a specific subregion size, 
for example, and specify how the clip scales within the subregion. If you want 
multiple clips to overlap, you should use subregions because you can set the 
clips’ stacking order by using the subregions’ z-index attributes. 


Layout Tag Summary 


The following SMIL sample illustrates the functions and relationships of the 
main layout tags. Layout markup goes in the SMIL header section, between 
<layout> and </layout> tags: 


<smil xmlns=“http://www.w3.org/2001/SMIL20/Language”> 
<head> 
<layout> 
<root-layout ...defines the main media pane’s overall size.../> 
<region id="ID1" ...defines a playback region within the main pane.../> 
<region id="ID2” ...defines a playback region that has a subregion...> 
<region id="ID3” ...defines a subregion.../> 
</region> 
<topLayout ...defines a secondary media window’s overall size...> 
<region id="ID4" ...defines a region within the secondary window.../> 
</topLayout> 
<regPoint id="ID5” ...defines a point where clips are placed in regions.../> 
</layout> 
</head> 
<body> 
...clips and groups... 
<ref src="...” region="ID1" regPoint="ID5" ...assigns a clip to a region 
and a registration point by IDs.../> 
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<ref src="...” region="ID2” ...assigns a clip to a region by ID.../> 
..more clips and groups... 
</body> 
</smil> 


For More Information: For more on the SMIL header and body 
sections, see “Header and Body Sections” on page 198. 


Creating Main and Secondary Media Windows 


The simplest layout defines a size for the RealOne Player main media playback 
pane, and creates a single playback region for clips. More complex layouts can 
create multiple regions, and even launch secondary, pop-up windows. The 
following sections explain how to define and set the sizes for the main media 
playback pane, as well as any secondary media playback windows you want to 
use. 


Defining the Main Media Playback Pane 


For every SMIL presentation that uses a layout, you use the <root-layout/> tag 
to set the main media playback pane’s width and height in pixels. The <root- 
layout/> tag requires height and width attributes. An id="ID" attribute is 
optional, and is generally required only if you use SMIL animations to change 
the pane size as the presentation plays. The following example creates a root- 
layout area 320 pixels wide by 240 pixels high: 
<layout> 

<root-layout width="320” height="240"/> 

...main media playback pane regions defined after the root-layout area... 
</layout> 


Because clips cannot play in the root-layout area, you need to define at least 
one region in addition to the root-layout area. In the following example, the 
single region automatically assumes the same size as the root-layout area: 
<layout> 

<root-layout width="320" height="240" /> 

<region id="video_region”/> 
</layout> 


For More Information: “Defining Playback Regions” on page 279 
explains how to set region sizes and positions within the main 
media playback pane. “Adding Background Colors” on page 
290 tells how to set pane colors. 
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Creating Secondary Media Playback Windows 


To add secondary, pop-up windows to a presentation, you include <topLayout> 
and </topLayout> tags for each window you want to launch. As with the <root- 
layout/> tag, you specify the width and height of each secondary media 
playback window in pixels. An id="I0” attribute is optional, and is generally 
required only for use with SMIL animations. The following example creates a 
secondary media playback window 180 pixels wide by 120 pixels high, and 
defines a single playback region of the same size: 
<layout> 

<root-layout.../> 

...main media playback pane regions defined... 

<topLayout width="180” height="120"> 

<region id=" popup_region”/> 

</topLayout> 

</layout> 


Note: Although functional, secondary media windows are 
currently plain windows that do not include the standard 
RealOne Player skin. 


For More Information: See “Defining Playback Regions” on page 
279 for information on setting region sizes and positions. 
“Adding Background Colors” on page 290 explains how to 
define a window color. 


Controlling When Secondary Media Windows Open and Close 


A <topLayout> tag can include open and close attributes that determine when 
the secondary media playback window appears and disappears. The following 
table describes the values these attributes can have. You can define one open 
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value, and one close value, or leave these attributes out of the tag to use the 
default values. 


Attributes for Opening and Closing Secondary Media Windows 


Attribute and Value Function 


open="onStart” Open the window when the presentation begins, regardless 
of when clips play in the window. Keep the window open 
until the presentation ends or the viewer closes the 
window. This is the default. 


open="whenActive” Open the window when a clip begins to play in a region 
within the window. 


close="onRequest” Close the window only when the viewer clicks the close 
button. This is the default. 


close="whenNotActive” | Close the window when clips stop playing in the window, 
or when the viewer clicks the close button. 


With the default values of open=“onStart” and close=“onRequest”, the secondary 
media playback window opens when the presentation begins (even if no clips 
play in the window immediately), and stays open until the viewer closes the 
window or starts another presentation. A common alternative is to make the 
window appear only when clips play in it, and close when those clips finish 
playing: 

<topLayout ... open="whenActive” close="whenNotActive”> 


Tips for Defining Secondary Media Playback Windows 


- A viewer can always close a secondary media playback window manually, 
regardless of the close attribute’s value. If a clip is assigned to play ina 
secondary media playback window the viewer has closed, RealOne Player 
still processes the streaming clip, but it doesn’t display the clip’s visual 
content. It will play any audio content, however. 


+ Content in secondary media playback windows does not appear when 
RealOne Player expands to full-screen mode. In this case, only the content 
playing in the main media playback pane (the <root-layout/> area) appears. 


+ You cannot control where a secondary media playback window pops up 
on the viewer’s screen. RealOne Player determines a placement based on 
the size of the main and the secondary media playback windows, as well as 
the arrangement of existing windows on the screen. 
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- If the secondary media playback window uses close=“whenNotActive”, a 
clip’s fill attribute can affect when the window closes. For more 
information, see “Setting a Fill” on page 327. 


+ The opening or closing of a secondary media playback window can start 
or stop another element. For more information, see “Defining a 
Secondary Window Event” on page 351. 


Controlling Resize Behavior 


Viewers can resize the main media playback pane and secondary media 
playback windows manually, or by choosing RealOne Player’s double-size or 
full-size mode. By default, all regions and clips resize accordingly. You can 
change this behavior, though, to allow only regions (and hence the clips 
within those regions) defined with percentage values to resize. In this case, 
clips playing in regions defined with pixel values will not resize. To do this, 
add the attribute rn:resizeBehavior="percentOnly” to the <root-layout> or 
<topLayout> tag: 


<root-layout width="250" height="230” rn:resizeBehavior="percentOnly” /> 


Using this attribute requires that you declare the following namespace in the 
<smil> tag: 


xmlns:rn=“http://features.real.com/2001/SMIL20/Extensions” 


For More Information: “Defining Region Sizes and Positions” on 
page 281 explains pixel and percentage values for regions. For 
background on customized attributes and namespaces, see 
“Using Customized SMIL Attributes” on page 203. 


Defining Playback Regions 


For the RealOne Player main media playback pane and each secondary media 
playback window, you need to define at least one region where clips play. For 
the main media playback pane, you define regions after the <root-layout/> tag. 
For secondary media playback windows, you define them between each 
window’s <topLayout> and </topLayout> tags. You create each region using a 
<region/> tag: 
<layout> 

<root-layout.../> 

<region id="ID1” ...defines a playback region within the root-layout area.../> 

<region id="ID2" ...defines a playback region within the root-layout area.../> 
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<topLayout...> 
<region id="ID3" ...defines a region within a secondary media window.../> 
<region id="ID4" ...defines a region within a secondary media window.../> 
</topLayout> 
</layout> 


A <region/> tag requires only a unique ID to create a region that expands to 
the same size as the main or secondary media playback window. In most cases, 
though, you'll want to create smaller regions and position them within the 
window using other <region/> tag attributes, which are described in the 
following sections. 


Setting Region IDs and Names 


Every region must have a unique, user-defined ID in the form id="ID". You 
assign clips to a region based on the region’s ID. The following SMIL example 
defines a region that uses video_region as its ID: 
<layout> 

<root-layout width="250" height="230"/> 

<region id="video_region” /> 
</layout> 


Optionally, a region can include a name in the form regionName="name”. 
Unlike IDs, region names do not have to be unique. In fact, region names are 
useful primarily when two or more regions share the same name. In this case, 
you can assign the same clip to play in multiple regions by using the region 
name rather than the region ID. The following is an example of a video clip 
with a region name: 


<region id="video_region1” regionName="videoregion” /> 
Although region names can be identical, no region name should be the same 


as a region ID. The following example is allowed because the IDs are unique 
even though the region names are identical: 


<region id="video_region1” regionName="videoregion”/> 
<region id="video_region2” regionName="videoregion”/> 


However, the following example is not allowed because the ID is not unique: 
<region id="video_region1” regionName="video_region1”/> 
For More Information: See “Playing the Same Clip in Multiple 


Regions” on page 307 and “Example 3: Media Playback Pane 
Resized for Captions” on page 462 for examples of assigning 
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clips to regions based on the region name rather than the ID. 
The section “SMIL Tag ID Values” on page 202 contains rules 
for specifying IDs. 


Defining Region Sizes and Positions 


If you do not specify a region’s size, the region becomes the same size as the 
window that contains it. For example, the following region expands to 320 
pixels by 240 pixels, the same size as the main media playback pane: 
<layout> 

<root-layout width="320" height="240"/> 

<region id="video_region”/> 
</layout> 


In most cases, though, you'll want regions to be smaller than the window that 
contains them. This lets you place regions side-by-side, or use the window 
background color as a border around a region. The following figure illustrates 
how a region’s size and position attributes control where the region appears 
within its window. 


Region Size and Position Attributes 


top 


left right 
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The region size and position attributes constitute a simple coordinate system 
measured in pixels or percentages. Because each attribute has a default value 
of auto, you can leave it out of the <region/> tag to set its value automatically 
based on the values of the other attributes. The result is that, in most cases, 


281 


RealNetworks Production Guide 


282 


you need to specify just one to four of the attributes listed in the following 
table. 


Region Size and Position Attributes 


Attribute Function Example 
bottom | Sets region’s bottom offset from window’s bottom border. | bottom="22" 
height | Specifies the region’s height. height="180" 
left Sets region’s left offset from window’s left border. left="20%" 
right Sets region’s right offset from window’s right border. right="5%”" 
top Sets region’s top offset from window’s top border. top="60" 
width Specifies the region’s width. width="240" 


Note: For size and position attributes, SMIL supports the use 
of px to designate pixels, as in top="60px”. This provides 
consistency with the Cascading Style Sheet 2 (CSS2) standard. 
In SMIL, though, the px designation is not necessary. For 
simplicity, this guide omits the px from pixel measurements. 


Layout Example 1: Region Width and Height 


This example shows a region in which only the width and height are defined: 

<region id="video_region” width="180" height="120"/> 

In this case, the region is placed in the window’s upper-left corner. The bottom 
and right offsets from the window borders are set automatically based on the 


region’s size and position. If the window were 300 pixels wide by 200 pixels 
high, you could achieve the same layout using percentage values: 


<region id="video_region” width="60%” height="60%" /> 
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Tip: With percentage values, the region changes size if you 
modify the sizing attributes of the <root-layout/> or 
<topLayout> tag that contains the region. With pixel 
measurements, though, the region size remains stable. 


Layout Example 2: Four Region Offsets 


top 


left at right 


bottom 


This example shows a region placed in a window without specifying the region 
size: 

<region id="video_region” left="60” right="60" top="40” bottom="40" /> 

In this case, the four offsets from the window borders determine the region 
size. If the window were 300 pixels wide by 200 pixels high, the region would 


be 180 pixels wide (300-60-60=180) and 120 pixels high (200-40-40=120). You 
could create the same layout with percentage values: 


<region id="video_region” left="20%” right="20%”" top="20%”" bottom="20%" /> 


Tip: If you define a region size with these offset attributes, 
changing the window’s size also changes the region’s size 
whether the attributes use pixels or percentages. 
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Layout Example 3: Region Sizes and Two Offsets 


top 


left 


This example shows a common way to define region size and position. It 
specifies a region width and height, then sets the region’s offset from the 
window’s upper-left corner: 


<region id="video_region” left="60" top="40" width="180" height="120" /> 


If the window were 300 pixels wide by 200 pixels high, the region layout would 
be the same as in “Layout Example 2: Four Region Offsets” on page 283. Using 
pixel measurements for the region width and height, however, keeps the 
region size stable if you modify the window size. 


Using Different Offset Values 
For this example, you could use the right and bottom attributes instead of left 
and top to create the same layout: 


<region id="video_region” right="60" bottom="40" width="180" height="120"/> 


Using Percentage Values 

You could also define this layout using percentage values for the left and top 
offsets. This keeps the region’s relative position within the window the same 
should you change the window size: 


<region id="video_region” left="20%” top="20%”" width="180" height="120"/> 
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Layout Example 4: Two Offsets 


right 


bottom 


This example sets the region’s size and position by specifying only the right 
and bottom attributes: 


<region id="video_region” right="60" bottom="40"/> 
Because neither the left nor the top attribute is defined, the region is placed in 


the window’s upper-left corner. The region’s width and height expand to meet 
the right and bottom offset values. 


Using Different Offset Values 
Alternatively, you could set the region’s left and top attributes instead of right 
and bottom to place the region at the window’s lower-right corner: 


<region id="video_region” left="60”" top="40"/> 


Layout Example 5: Single Offsets for Two Regions 


Typically, you'll need to define more that one region within a window to lay 
out clips that play together. To do this, you define each region with a separate 
<region/> tag, using any combination of size and position attributes to place 
each region in its window. 
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This example shows two regions laid out so that a small stripe of the root- 
layout background appears between the regions. Because vertical size or offset 
values (top, height, or bottom) are not specified, each region is as tall as the 
root-layout area: 

<region id="region_1” right="55%"/> 

<region id="region_2” left="55%" /> 


Layout Example 6: Overlapping Regions 


EA 
or 


This example has one region in front of another. There are many ways to 
define this layout with the size and position attributes. The following sample 
uses percentage values for the four border offsets: 


<region id="region_1” top="5%" left="5%" bottom="5%" right="5%" /> 
<region id="region_2” top="25%" left="25%" bottom="25%" right="25%" /> 


Note: Whenever regions overlap, you should also define how 
the regions stack with the z-index attribute. See “Stacking 
Regions That Overlap” on page 288 for more information. 
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Tips for Defining Region Sizes and Offsets 


- All regions appear within the <root-layout/> or <topLayout> area that 
contains them. Any part of a region defined to appear outside of its 
containing window is cut off. For this reason, no percentage value can 
effectively be more than 100%. 


You can mix pixel and percentage values. You could define the top and left 
attributes in percentages, for example, while specifying width and height in 
pixels. 


If you mix pixel and percentage values when defining regions, and you 
also use rn:resizeBehavior="percentOnly” as described in “Controlling Resize 
Behavior” on page 279, manually resize the RealOne Player window. If 
regions do not resize as expected, you may need to change some pixel 
values to percentages, or vice versa. 


You can use both whole and decimal values for percentages. For example, 
the values “4%” and “4.5%” are both valid. 


An audio clip does not require a region for playback. However, you can use 
a <region/> tag’s soundLevel attribute to control the relative volume of an 
audio clip. See “Controlling Audio Volume in a Region” on page 292 for 
more information, and “Turning Down an Audio Clip’s Volume” on page 
305 for an example. 


Assigning Clips to Regions 


After you define the playback regions, you use region attributes within clip 
source tags to assign clips to regions based on the region’s ID. In the following 
example, the video and text clips are assigned to the video and text regions 


defined in the header: 
<smil xmlns=“http://www.w3.org/2001/SMIL20/Language”> 
<head> 
<layout> 


<root-layout backgroundColor="maroon” width="250” height="230”" /> 
<region id="video_region” top="5" left="5" width="240" height="180"/> 
<region id="text_region” top="200” left="5" width="240” height="20"/> 
</layout> 
</head> 
<body> 
<par> 
<video src="video.rm” region="video_region” .../> 
<audio src="audio.rm”/> 
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<textstream src="text.rt” region="text_region” .../> 


</par> 
</body> 
</smil> 


You can reuse regions by assigning sequential clips to them. For example, you 
can play a video clip in a region, then display another clip in that region after 


the first clip finishes. You don’t need to assign audio-only clips to regions at 
all because audio does not display on the screen. 


Stacking Regions That Overlap 


When you define multiple regions that overlap, you can use a z-index attribute 
in <region/> tags to specify how regions stack. The following layout example 
creates a video region that overlaps an image region: 
<layout> 
<root-layout width="280” height="220”" /> 
<region id="image” top="10" left="10" width="260” height="200” z-index="0" /> 
<region id="video” top="20” left="20" width="240”" height="180" z-index="1"/> 
</layout> 


In this example, the root-layout area is 220 pixels high by 280 pixels wide. The 
smaller image region is centered on the root-layout area. Its z-index value of 0 
makes it display behind all other regions, but not behind the root-layout area. 
The video region centered on the image region appears in front of that region 
because of its higher z-index value. You could have another region overlap the 
video region by setting its z-index value to 2, 5, or 29, for instance. The 
following figure illustrates these regions. 


Regions Overlapping Through z-index 
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+ The root-layout area always appears behind all regions. The <root-layout/> 


tag cannot have a z-index attribute. 


+ The z-index values can include negative integers (such as -4), 0 (zero), and 


positive integers (such as 5). A region with a z-index value of -4, for 


example, displays behind a region with a value of 0, which displays behind 


a region with a value of S. 


+ The default value of 0 (zero) applies if you don’t specify z-index. 


- Using strictly sequential values such as 0, 1, 2, 3, 4 helps you keep track of 


the layers, but is not necessary. A sequence such as 0, 10, 20, 30, 40 works 


just as well, and leaving gaps in the sequence makes it easier to insert 


layers later. 


- Nonoverlapping clips can have the same values. Side-by-side videos can 


both use z-index="3", for example. 


+ When overlapping clips have the same z-index value, the clip that starts 


later in the presentation displays in front. If both clips start at the same 
time, the clip with the source tag that appears later in the SMIL file 


displays in front. 
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Adding Background Colors 


By default, <root-layout/> and <topLayout> areas have a black background. All 
regions and subregions are transparent. In a <root-layout/>, <topLayout>, or 
<region/> tag, you can specify a different background color with the 
backgroundColor attribute, as shown in the following example: 
<layout> 

<root-layout backgroundColor="maroon”.../> 

<region id="region1” backgroundColor="rgb(100,65,230)”.../> 

<region id="region2” backgroundColor="#C2EBD7”.../> 

<region id="region3” backgroundColor="inherit”.../> 
</layout> 


For the color value, you can use inherit to make the region use the same color 
as the window or region that contains it. In the example above, the third 
region inherits maroon as its background color. To set a color value explicitly, 
use a predefined color name, a hexadecimal color value, or an RGB value. 


For More Information: Appendix C explains the types of color 
values you can use with SMIL. 


Tip: Using SMIL animation, you can change a region’s 
background color as the presentation plays. See Chapter 17 for 
more information. 


Setting When Background Colors Appear 


By default, all background colors in all regions display when the presentation 
starts. In some cases, though, you may not want a region’s background color 
to appear until a clip plays in the region. To do this, add 
showBackground="whenActive” to the <region/> tag: 


<region id="region1” backgroundColor="silver” showBackground=“whenActive”.../> 


Making a Region Partially Transparent 


A SMIL region is fully transparent if you do not define its background color, 
or you explicitly set backgroundColor="transparent” in the <region/> tag. You can 
also make a region’s background color partially transparent with the 
customized attribute rn:opacity="n%": 

<region id="region1” backgroundColor="blue” rn:opacity="50%".../> 

This attribute uses a percentage value from 0% (fully transparent) to 100% 
(fully opaque). In the example above, the value of 50% makes the region 
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background a partially transparent blue. Using this attribute requires that you 
declare the following namespace in the <smil> tag: 


xmlns:rn=“http://features.real.com/2001/SMIL20/Extensions” 


For More Information: You can modify transparency in clips, 
too. See “Modifying Clip Colors” on page 222 for details. For 
background on customized attributes and namespaces, see 
“Using Customized SMIL Attributes” on page 203. 


Transparency in Regions and Clips 


If a clip that contains transparency (such as a GIF image) plays in a 
transparent or partially transparent region, viewers will be able see through 
the clip’s transparent areas to underlying regions and clips. The following clip 
types can include transparent areas: 


+ RealVideo 

+ RealPix 

» RealText 

- Flash 

+ GIF and PNG images 


RealOne Player can play other types of clips, too, and some of those clips may 
include transparency. Support for transparency for each clip type has to be 
built into RealOne Player, however. Some clips that display transparency when 
rendered in a Web browser, for example, may not display transparency when 
played in RealOne Player. 


Tip: To check if RealOne Player recognizes a clip’s 
transparency, open the clip in RealOne Player and see if the 
window background shows through the clip’s transparent 
areas. You can also turn a clip’s background color transparent 
with rn:backgroundOpacity, as well as use rn:mediaOpacity to add 
transparency to all colors in the clip. For more on these 
attributes, see “Adjusting Clip Transparency and Opacity” on 
page 223. 


Changing the Region Color Through a Clip Source Tag 


By adding backgroundColor to a clip source tag, you can change the color of the 
clip’s playback region. Suppose that a region uses black as a background color, 
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and you want to play one clip in that region using a silver background instead. 
Rather than define a new region, you can specify the color in the clip source 
tag to modify the region color for as long as the clip is active: 


” 


<video src="...” region="video_region” backgroundColor="silver" .../> 


Controlling Audio Volume in a Region 


When a region plays a clip that includes an audio track or sound effects, you 
can change the clip’s relative audio volume with the soundLevel attribute: 


<region soundLevel="125%".../> 


The sound level always uses a percentage value. The default value of 100% 
plays the audio at its recorded volume. A value of 50%, for example, plays the 
audio at half its normal volume, whereas a value of 200% plays the audio at 
twice its normal volume. 


Note that the soundLevel attribute controls only the relative volume of the 
audio stream sent to the speakers. It does not change the general sound level 
setting on the viewer’s computer, which remains entirely under the viewer’s 
control. All sound level adjustments are subject to limitations in the computer 
hardware. 


For More Information: See “Turning Down an Audio Clip’s 
Volume” on page 305 for an example of how to use this 
attribute to change the volume of an audio clip. 


Tip: Using a SMIL animation, you can dynamically adjust a 
region’s soundLevel attribute to fade a clip’s volume in or out. 
See Chapter 17 for more information. 


Defining Subregions 


A subregion functions exactly like a main region, except that it maintains its 
position within its containing region if you reposition the containing region. 
To create a subregion, you need to modify the containing region to use 
<region> and </region> tags instead of a single <region/> tag. You then create 
the subregion between the containing region’s <region> and </region> tags, as 
shown in the following example, in which the subregion displays near the 
containing region’s lower-right corner: 
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<head> 
<layout> 
<root-layout width="350”" height="270"/> 
<region id="video_region” top="15” left="15” width="320" height="240"> 
<region id="logo” bottom="5%" right="5%" width="20" height="20"/> 
</region> 
</layout> 
</head> 


You lay out a subregion within its containing region using the attributes 
described in “Defining Region Sizes and Positions” on page 281. When you set 
these attributes, keep in mind that the offset measurements of left, right, top, 
and bottom are measured from the containing region’s boundaries. The 
subregion always falls completely within the containing region. 


For More Information: See “Binary and Unary Tags” on page 201 
for background information on converting a single <region/> 
tag to its binary equivalent. 


Tips for Defining Subregions 
- A region can hold any number of subregions. 


+ Subregions can be nested. A subregion can have a subregion of its own, for 
example. 


All subregions must have unique IDs. A subregion cannot have the same 
ID as another region or subregion. 


A subregion can take any <region/> tag attribute, and it does not 
automatically inherit any attributes from the containing region. For 
example, if you use fit="fill” in the containing region, and do not specify 
fit in the subregion, the subregion uses the default fit="hidden” rather 
than fit="fill’”. 


A subregion can have a background color the same as or different from its 
containing region. To keep the subregion the same color as the containing 
region, use backgroundColor="inherit”. See “Adding Background Colors” on 
page 290 for more on colors. 


Because subregions always appear in front of their containing region, it is 
not necessary to set subregion z-index values unless multiple subregions 
within the containing region overlap. In this case, the subregion z-index 
values apply only to the subregions within the containing region. For 
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example, suppose you define two overlapping regions, and one of these 
regions has two overlapping subregions: 
<region id="regionA” z-index="1".../> 
<region id="regionB” z-index="2”...> 

<region id="subregionC” z-index="1".../> 

<region id="subregionD” z-index="2".../> 
</region> 
In this example, the subregion z-index values of 1 and 2 have no 
relationship to the region z-index values of 1 and 2. As a result, region B 
appears in front of region A because it has a higher z-index value. Within 
region B, subregion D appears in front of subregion C. 


Creating a subregion in the layout section is useful if several clips will play 
in the subregion. But you can also create subregions “on the fly” within 
the clip source tag. See “Defining Single-Use Subregions” on page 294 for 
more information. 


Defining Single-Use Subregions 


Defining subregions in the SMIL header section is useful if you plan to reuse 
the subregion for multiple clips. If you want to create a subregion for just one 
clip, though, you can define the region in the clip source tag: 
<layout> 

<root-layout backgroundColor="maroon” width="250" height="230"/> 

<region id="video_region” top="5" left="5" width="240" height="180"/> 
</layout> 


<video src="video.rm” region="video_region” height="120” width="180” 
left="5" top="10"/> 


In the preceding example, the video clip is assigned to an existing region, but 
the inclusion of height, width, left, and top values defines a single-use 
subregion within that region. Unlike a subregion defined in the <layout> 
section, this single-use subregion does not require an ID value. The following 
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table lists all the region attributes that you can include in a clip source tag to 


seta single-use subregion’s properties. 


Single-Use Subregion Attributes 


Attribute Function Reference 
backgroundColor | Selects the subregion’s background color. page 290 
bottom Sets the subregion’s bottom offset. page 281 
fit Specifies how the clip fits its allotted space page 301 
height Specifies the subregion’s height. page 281 
left Sets the subregion’s left offset. page 281 
regAlign Aligns the clip to the registration point. page 296 
regPoint Defines the registration point for the subregion. page 295 
right Sets the subregion’s right offset. page 281 
top Sets the subregion’s top offset. page 281 
width Specifies the subregion’s width. page 281 
z-index Sets stacking order relative to other subregions. page 288 


Positioning Clips in Regions 


When you do not want a clip to align with a region’s upper-left corner, you can 


create a registration point. For example, you might define a registration point 


that is 10 pixels in, and 5 pixels down, from the region’s upper-right corner. A 


registration point also includes an alignment that determines which part of 


the clip is placed on the point. The alignment might place the midpoint of the 


clip’s right border on the registration point, for instance. 


Within a SMIL file you can define any number of registration points using 


either or both of the following methods: 


+ Method 1: Define each registration point within each clip source tag. 


Although simpler, this method limits you to placing each clip near the 


center of a region, or along the region border. Plus, you must define each 


registration point separately in each clip tag. The section “Defining 


Registration Points in Clip Source Tags” on page 296 explains this 


method. 
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+ Method 2: Define registration points with <regPoint/> tags in the layout 
section, then assign the points to clips. 


Although slightly more complex, this method is more powerful. It lets you 
place a clip anywhere within a region, and you can reuse each registration 
point in any number of clips. The section “Creating a Reusable 
Registration Point” on page 298 explains how to use this method. 


Using Alignment Values 


No matter which method you use to define registration points, you choose 
one of nine values to align a clip to a region: topLeft, topMid, topRight, midLeft, 
center, midRight, bottomLeft, bottomMid, or bottomRight. The following figure 
illustrates where these values fall on a clip: 


Alignment Values on Clips 


topMid 
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Defining Registration Points in Clip Source Tags 


To define a registration point within a clip source tag, you add regPoint and 
regAlign attributes to the tag. Both regPoint and regAlign use an alignment 
value as described in the preceding section, but the values have different 
meanings for the two attributes: 


+ The alignment value used with the regPoint attribute determines where 
the registration point falls in the region (hence, the alignment value 
applies to the region, not to the clip). 


+ The alignment value used with the regAlign attribute specifies which part 
of the clip aligns to the registration point. 
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For example, the following values center the clip in its region, regardless of the 
region’s size and shape: 


” 


<ref src=...” region="video_region” regPoint="center” regAlign="center”/> 


The next values select the region’s lower-right corner, and place the clip’s right 
midpoint at that corner. In this case, the clip’s bottom half is cut off: 


” 


<ref src="...” region="video_region” regPoint="bottomRight” 
regAlign="midRight”/> 


Avoiding Problems When Defining Registration Points 


Because you can use any of the nine predefined values for both regPoint and 
regAlign, there are 81 possible ways to place clips in regions using this method. 
Not all possibilities are useful, though. Consider this alignment: 


” 


<ref src="...” region="video_region” regPoint="topLeft” regAlign="bottomRight”/> 


In the preceding example, regPoint="topLeft” puts the registration point at the 
region’s upper-left corner. The regAlign="bottomRight” attribute places the 
clip’s lower-right corner on the registration point. This locates the clip outside 
the region. Because a clip cannot display outside its region, the clip does not 
display at all. 


Using Common Registration Point Values in Clip Source Tags 


The following table lists some of the more useful combinations of regPoint 
and regAlign that you can include in a clip source tag. 


Common Registration Point Values in Clip Source Tags 


Clip Placement Registration Point Values Example 
top left (default) regPoint=“topLeft” regAlign=“topLeft” 

top center regPoint=“topMid” regAlign=“topMid” 

top right regPoint=“topRight” regAlign=“topRight” 

middle left regPoint="midLeft” regAlign="midLeft” 

center regPoint="center” regAlign="center” 

middle right regPoint="midRight” regAlign="midRight” 

bottom left regPoint=“bottomLeft” regAlign=“bottomLeft” 


(Table Page 1 of 2) 
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Common Registration Point Values in Clip Source Tags (continued) 


Clip Placement Registration Point Values Example 
bottom center regPoint="bottomMid” regAlign="bottomMid” 
bottom right regPoint="bottomRight” regAlign="bottomRight” 


upper-left quadrant | regPoint="center” regAlign=“bottomRight” 


upper-right quadrant | regPoint="center” regAlign=“bottomLeft” 


lower-left quadrant | regPoint="center” regAlign=“topRight” 


lower-right quadrant | regPoint="center” regAlign=“topLeft” 


(Table Page 2 of 2) 


Creating a Reusable Registration Point 


Using the second method for creating registration points, you define each 
registration point in the layout section with a <regPoint/> tag. As shown in the 
following example, a <regPoint/> tag has a unique ID, a few positioning 
attributes, and a regAlign attribute: 
<layout> 

...windows and regions defined here... 

<regPoint id="above_center” left="50%”" top="25%”" regAlign="topMid”/> 
</layout> 


The preceding <regPoint/> tag creates a registration point halfway in from the 
left, and a quarter of the way down from the top, of any region. The regAlign 
value, described in “Using Alignment Values” on page 296, places the 
midpoint of the clip’s top border on the registration point. 


Positioning the Registration Point 


A <regPoint/> tag’s left, right, top, and bottom attributes, which can have pixel 
or percentage values just like region offset values, allow you to place the 
registration point anywhere in a region. You need to use only one or two of 
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these attributes (such as left and top, or right and bottom) to define a 
registration point’s position. The following table summarizes these attributes. 


<regPoint/> Tag Position Attributes 


Attribute Function Example 

left Sets the point’s offset from region’s left border left="120" 
right Sets the point’s offset from region’s right border right="5%”" 
top Specifies the point’s offset from region’s top border top="60" 
bottom | Specifies the point’s offset from region’s bottom border | bottom="22%" 


Assigning a Registration Point to Clips 


Once you define a registration point in the layout section, you assign the 
point to any number of clips by adding a regPoint attribute to each clip source 
tag. This attribute takes as its value the ID of the <regPoint/> tag. For example, 
if you defined this registration point: 


<regPoint id="above_center” left="50%”" top="25%”" regAlign="topMid” /> 

you use the following regPoint attribute in the clip source tag: 

<ref src="...” region="video_region” regPoint="above_center” .../> 

In the clip source tag, you can even override the regAlign value defined for the 
registration point. Suppose that for one clip you want to use regAlign="center” 


instead of the defined regAlign="topMid”. You can simply add the new regAlign 
value to the clip tag, rather than define a new registration point: 


<ref src="...” region="region2” regPoint="above_center” regAlign="center” .../> 


Note: You cannot override a registration point’s position 
attributes, such as left and top, through a clip source tag. 


Using Common Values in <regPoint/> Tags 


Using <regPoint/> tags, you can replicate any registration point definable 
through clip source tags. The following table shows how to create common 
registration point alignments with values in a <regPoint/> tag rather than with 
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attributes in clip source tags. Note that although left and top attributes are 
used, you could define the same registration points using right and bottom. 


Common Registration Point Values in <regPoint/> Tags 


Clip Placement Registration Point Values Example 
top left (default) left="0%" top="0%" regAlign=“topLeft” 

top center left="50%" top="0%”" regAlign="“topMid” 

top right left="100%”" top="0%”" regAlign=“topRight” 
middle left left="0%" top="50%”" regAlign="midLeft” 

center left="50%" top="50%”" regAlign="center” 

middle right left="100%”" top="50%" regAlign="midRight” 
bottom left left="0%”" top="100%”" regAlign=“bottomLeft” 
bottom center left="50%" top="100%”" regAlign="bottomMid” 
bottom right left="100%" top="100%” regAlign="bottomRight” 
upper-left quadrant | left="50%" top="50%" regAlign=“bottomRight” 
upper-right quadrant | left="50%" top="50%" regAlign=“bottomLeft” 
lower-left quadrant | left="50%" top="50%" regAlign=“topRight” 
lower-right quadrant | left="50%" top="50%" regAlign=“topLeft” 


Tips for Defining <regPoint/> Tags 


- Do not use an alignment value, such as topLeft, as an ID in a <regPoint/> 
tag. Any variation, such as id="alignTopLeft” is OK, however. For 
information about IDs, see “SMIL Tag ID Values” on page 202. 


+ To keep the organization clear in the layout section, define all registration 
points after the <region/> tags. 


+ Keep in mind that <regPoint/> tags are not associated directly with 
<region/> tags. They affect regions only through the clips that play in 


300 


CHAPTER 12: Layout 


those regions. In other words, you assign registration points to clips, and 
clips to regions. 


If you do not specify any position attributes, the registration point is 
placed in the region’s upper-left corner. 


You can mix pixel and percentage values in position attributes, using 
left="10" and top="15%", for example. 


Because a single registration point can apply to any region of any size, it is 
easier to define position attributes with percentages than with pixels. 


Because you can reuse a registration point defined in a <regPoint/> tag for 
any number of clips, it’s better to use this method when you want to align 
many clips the same way. Once you define the <regPoint/> tag, you just 
add the single regPoint="ID" attribute to each clip tag, rather than both 
regPoint="value” and regAlign="value”. 


Take care not to cut off or hide clips. For example, consider these 
registration point attributes: 


left="0%" top="100%”" regAlign=“topRight” 
These left and top attributes place the registration point at the region’s 
lower-left corner. The regAlign attribute places the clip’s upper-right 


corner on the point. This locates the clip outside the region. Because a clip 
cannot display outside its region, the clip does not display at all. 


Different sizes of regions and clips, the use of registration points, and the 
setting of a region’s fit attribute can create many different outcomes for 
the placement and scaling of a visual clip. For more information, get the 
zipped HTML version of this guide as described in “How to Download 
This Guide to Your Computer” on page 12, and view the supplemental 
align.htm file. 


Fitting Clips to Regions 


Whereas a registration point determines where a clip displays in a region, a fit 
attribute specifies what happens when a clip is larger or smaller than its 
allotted area. The various fit values determine whether resizing, distortion, 
and cropping may occur. The fit attribute is part of a <region/> tag, not a 
<regPoint/> tag, and it applies to a clip playing in the region whether or not the 
clip uses a registration point. The following example shows a fit attribute set 
in a <region/> tag: 
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<region id="video_region” width="128" height="64” fit=" meet” /> 


fit Attribute Values 


The fit attribute uses one of the values described in the following table. The 
table’s last three columns indicate if the fit attribute value may scale, distort, 
or crop the clip if it does not fit the region dimensions exactly. 


Re 
= el zs 
zs) a fe) 

fit Value Function 8 Oo 6 

fill Place the clip in the region’s upper-left corner, or at the _| yes | yes | no 

registration point. Scale the clip so that it fills the region 
exactly. Image distortion occurs if the encoded clip and 
playback region have different aspect ratios. 
hidden Keep the clip at its encoded size, and place it in the no |no |yes 
(default) | region’s upper-left corner, or at the registration point. If 
the clip is smaller than the region, fill the remaining space 
with the region’s background color. If the clip is larger 
than the region, crop out the area that does not fit. 
meet Place the clip at the region’s upper-left corner or at the yes |no |no 
registration point. Scale the clip and preserve its width-to- 
height ratio until one dimension is equal to the region’s 
size and the other dimension is within the region’s 
boundaries. Fill empty space with the region’s 
background color. 
scroll Place the clip at the region’s upper-left corner or at the no |no |no 
registration point. Display the clip as its normal size, 
adding horizontal or vertical scroll bars if the clip extends 
beyond the region’s boundaries. (RealPlayers earlier than 
RealPlayer 8 display clips as hidden instead.) 
slice Place the clip at the region’s upper-left corner or at the yes |no | yes 
registration point. Scale the clip and preserve its width-to- 
height ratio until one dimension is equal to the region’s 
size and the other dimension overflows the region’s 
boundaries. Crop the overflow. 


The following illustration shows the effects that particular fit attribute values 
have on a source clip played in regions with different sizes and aspect ratios. 
Note that in some cases, based on the width-to-height ratio of the clip and the 
width-to-height ratio of the region, certain fit values have nearly the same 
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effect. But display the same clip in a region with a different width-to-height 
ratio, and the fit values can have very different effects. 


A Clip Played in Different Regions with Different fit Attribute Values 
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Overriding a Region’s fit Attribute 


You can override a region’s fit attribute within a clip source tag. Suppose that 
a certain region uses fit="fill”, but you want to play one clip in that region and 


use fit=“hidden” instead. You can simply add that fit value to the clip source tag 
to override the region’s fit value: 


<video src="...” region="textregion” fit="hidden” .../> 


Tips for Defining the fit Attribute 


+ Use fit="meet” if all parts of the clip must display, if the clip’s aspect ratio 
must be maintained, and if it’s OK to scale the clip. 


+ Use fit="hidden” or fit="“scroll” to keep the clip at its encoded size. 


+ Use fit="fill” if you want to fill the entire region with the clip and it 
doesn’t matter if RealOne Player enlarges, shrinks, or distorts the clip. 
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+ When scaling clips inside a region, keep in mind that different types of 
media scale with different results. A video scaled to a different width-to- 
height ratio may not look good. Vector-based media such as Flash 
animation, on the other hand, scale more easily to fit different region 
sizes. Also, note that scaling a clip consumes CPU power on the RealOne 
Player computer. 


For recommendations on using the fit attribute with a RealText clip, see 
“RealText Window Size and SMIL Region Size” on page 117. 


When you use the fill, meet, or slice value, a hot spot hyperlink (image 
map) defined with percentage values automatically resizes with the clip. 
For more information, see “Tips for Defining Hot Spots” on page 365. 


Different sizes of regions and clips, the use of registration points, and the 
setting of a region’s fit attribute can create many different outcomes for 
the placement and scaling of a visual clip. For more information, get the 
zipped HTML version of this guide as described in “How to Download 
This Guide to Your Computer” on page 12, and view the supplemental 
align.htm file. 


Layout Examples 
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The following sections illustrate how to use layout tags and attributes to 
create various types of presentations. To see more examples, get the zipped 
HTML version of this guide as described in “How to Download This Guide to 
Your Computer” on page 12, and view the Sample Files page. 


Centering a Video on a Background Image 


This example centers a video clip in front of an image. Because region sizes are 
not specified, the regions expand to the root-layout size. The registration point 
centers the video clip within its region. The z-index attributes place the video 
region in front of the image region. The image region’s fit="fill” attribute 
expands the image to fill the entire region, distorting the image if the image 
does not have the same aspect ratio as the region: 
<smil xmlns=“http://www.w3.org/2001/SMIL20/Language”> 
<head> 
<layout> 

<root-layout width="320" height="240"/> 

<region id="image_region" fit="fill" z-index="1"/> 

<region id="video_region" fit="hidden" z-index="2"/> 
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<regPoint id="middle" regAlign="center" left="50%" top="50%"/> 
</layout> 
</head> 
<body> 
<par> 
<img src="background.gif" region="image_region" dur="10s" fill="freeze"/> 
<video src="videol.rm" region="video_region" regPoint="middle"/> 
</par> 
</body> 
</smil> 


Note: SMIL provides no way to tile an image throughout a 
region. 


Displaying a Letterbox Clip 


A wide screen movie displays on most television sets in a letterbox format, in 
which blank areas display above and below the movie. As shown in the 
following example, you can achieve the same effect for a clip that has a width- 
to-height ratio greater than its region’s. Here, the video uses a registration 
point that centers it in a region that uses fit="meet” to scale the video up or 
down in size until its left and right edges meet the region boundaries: 
<smil xmlns=“http://www.w3.org/2001/SMIL20/Language”> 
<head> 
<layout> 
<root-layout width="400”" height="300"/> 
<region id="video_region” fit="meet” /> 
</layout> 
</head> 
<body> 
<video src="widescreen.rm” region="video_region” regPoint="center” 
regAlign="center”/> 
</body> 
</smil> 


Turning Down an Audio Clip’s Volume 


Although audio-only clips are not typically assigned to regions, you can take 

advantage of a region’s soundLevel attribute to change an audio clip’s volume. 
The following example cuts the volume of a background music clip. The single 
playback region (1 pixel by 1 pixel) uses the soundLevel attribute to turn down 
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the clip volume. Because the second clip is assigned to this region, RealOne 
Player cuts that clip’s audio level as it blends it with the first clip: 
<smil xmlns=“http://www.w3.org/2001/SMIL20/Language”> 
<head> 
<layout> 
<root-layout height="1" width="1"/> 
<region id="lowvolume” soundLevel="35%"/> 
</layout> 
</head> 
<body> 
<par> 
<audio src="voiceover.rm”/> 
<audio src="background_music.rm” region="lowvolume” /> 
</par> 
</body> 
</smil> 


Playing Three Clips Side-by-Side 


The following example displays three regions: a news region, a video region, 
and a stock ticker region. The news and video regions are arranged side-by-side 


at the top of the RealOne Player main media playback pane. The stock ticker 
region appears below them: 


<smil xmlns=“http://www.w3.org/2001/SMIL20/Language”> 
<head> 


<layout> 
<root-layout height="230" width="510" backgroundColor="black"/> 
<region id="news_region" width="240" height="180" left="5" top="5"/> 
<region id="video_region" width="240" height="180" right="5" top="5"/> 
<region id="ticker_region" width="500" height="30" left="5" bottom="5"/> 
</layout> 
</head> 
<body> 
<par endsync="news"> 
<textstream src="news.rt" id="news" region="news_region" fill="freeze" /> 
<video src="video1.rm" region="video_region" fill="freeze"/> 
<textstream src="ticker.rt" region="ticker_region" fill="freeze"/> 
</par> 
</body> 
</smil> 
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Placing a Clip in a Secondary Media Playback Window 


A small change to the preceding example’s layout can make one of the three 
clips display in a secondary, pop-up window. The following example places the 
stock ticker clip in a secondary media playback window that automatically 
opens when the presentation starts. The region that holds the stock ticker clip 
has no size and position information, so it automatically assumes the size of 
the secondary media playback window. The root-layout area’s height has 
decreased, but within the SMIL body nothing has changed: 


<smil xmlns=“http://www.w3.org/2001/SMIL20/Language”> 
<head> 
<layout> 
<root-layout height="190" width="510" backgroundColor="black"/> 
<region id="news_region" width="240" height="180" left="5" top="5"/> 
<region id="video_region" width="240" height="180" right="5" top="5"/> 
<topLayout width="500" height="30"> 
<region id="ticker_region"/> 
</topLayout> 
</layout> 
</head> 
<body> 
<par endsync="news"> 
<textstream src="news.rt" id="news" region="news_region" fill="freeze" /> 
<video src="video1.rm" region="video_region" fill="freeze"/> 
<textstream src="ticker.rt" region="ticker_region" fill="freeze"/> 
</par> 
</body> 
</smil> 


Playing the Same Clip in Multiple Regions 


You normally assign a clip to a single region based on the region ID. Because 
each region ID must be unique, however you cannot assign the same clip to 
multiple regions by using region IDs. However, you can assign the same clip to 
two or more regions based on the region names. In the following example, the 
same video plays in two regions that appear size by side: 
<smil xmlns=“http://www.w3.org/2001/SMIL20/Language”> 
<head> 
<layout> 
<layout> 
<root-layout width="360" height="120"/> 
<region id="video_region1" regionName="video" soundLevel="0%" 
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right="50%" fit="fill" /> 
<region id="video_region2" regionName="video" left="50%" fit="fill"/> 
</layout> 
</head> 
<body> 
<seq> 
<video src="video1.rm" region="video"/> 


</seq> 
</body> 
</smil> 


In the preceding example, the two regions share the same region name. When 
it reads the <video/> source clip tag, RealOne Player first looks for a region 
with id=“video”. Because there is no such region, RealOne Player looks for a 
region with regionName=“video”. In this example, it finds two regions with this 
name, so it plays the same clip in both regions. 


With this strategy, RealOne Player requests only one video clip from Helix 
Universal Server. If you used two <video/> source clips instead, RealOne Player 
would request the same video stream twice, wasting bandwidth. Note, too, 
that one region turns off the video’s audio track with the soundLevel attribute. 
If two clips have audio tracks, RealOne Player blends the tracks. In this case, 
that’s unnecessary because the tracks are identical. 


PART 


Vi 


TIMING AND LINKING CLIPS 


Streaming media flows. Controlling when your media clips play is 
a crucial component for delivering a successful presentation. 
Chapter 13 introduces you to SMIL timing. Chapter 14 builds 
on that knowledge by explaining advanced timing features. To 
learn how to link your presentation to a Web page or another 
streaming presentation, read Chapter 15. 


CHAPTER 


13 


BASIC TIMING 


SMIL’s timing attributes help you to tailor your presentation. You 
can use these attributes to adjust when clips start to play. Or you 
might stream just one scene from a video to create a preview without 
encoding a separate video clip. This chapter describes the basic 
SMIL timing features. Once you master these features, you can 


tackle advanced timing as described in Chapter 14. 


Understanding Basic Timing 


SMIL timing attributes are optional, giving you a powerful way to customize 
g Pp » Ziving y P y 
presentations by specifying when and how long elements play. Before you use 
SMIL timing attributes, though, you should know how you want to construct 
g ) gh, y' y 
your overall presentation timeline. For more on this, see “Step 5: Organize the 
Presentation Timeline” on page 52. 


Note: This chapter uses the term element to indicate anything 
that can use a SMIL timing attribute. For simple presentations, 
elements are typically clip source tags like <video/> and group 
tags like <par>. But you can also use timing attributes in tags 
such as <prefetch/>, <animate/>, and <area/>. 


Groups Create the Timing Superstructure 


The <seq>, <par>, and <excl> group tags set the basic timing structure for a 
presentation. To stream a sequence of videos, for example, you do not need to 
use SMIL timing attributes. You simply arrange the clips in a <seq> group as 
described in Chapter 11. Your presentation timeline then flows automatically 
from the clip timelines and the group arrangement. You need to add timing 
attributes only if, for example, you want to add a pause between each clip, 
shorten the time a clip plays, or play just one scene from a clip. 
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Timing is Relative to Groups 


In general, timing attributes for an element are relative to the group that 
contains the element. For elements in a <seq> group, timing attributes are 
relative to the end of the preceding element. For elements in a <par> or <excl> 
group, they’re relative to the start of the group. The following example shows 
a sequence that consists of a parallel group followed by a video clip. For the 
audio clip, for example, the timing attributes are relative to the start of the 
<par> group: 
<body> 
<seq ...timing is relative to the start of the presentation...> 
<par ...timing is relative to the start of the sequence...> 
<textstream ...timing is relative to the start of the parallel group.../> 
<audio ...timing is relative to the start of the parallel group.../> 
</par> 
<video ...timing is relative to the end of the preceding parallel group.../> 
</seq> 
</body> 


Timing Attributes Covered in this Chapter 


The following are the basic SMIL timing attributes described in this chapter: 
* begin, end, dur 


These attributes set the total length of time that an element plays. They 
are the most widely used of the SMIL timing attributes. See “Setting Begin 
and End Times” on page 314 and “Setting Durations” on page 317. 


¢ clipBegin, clipEnd 


These attributes let you play just a portion of a clip, such as a certain scene 
out of a video. See “Setting Internal Clip Begin and End Times” on page 
316. 


* min, max 


These attributes let you set absolute boundaries for how little or how long 
an element can play. See “Setting Minimum and Maximum Times” on 
page 320. 


* endsync 


This attribute ends a parallel or exclusive group when a certain element in 
the group ends. See “Ending a Group on a Specific Clip” on page 320. 
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¢ repeatCount, repeatDur 


The repeatCount and repeatDur attributes let you repeat an element a 
specific number of times, or for as many repetitions as possible within a 
certain time. See “Repeating an Element” on page 323. 


+ mediaRepeat 
With mediaRepeat, described in “Stopping a Clip’s Encoded Repetitions” 


on page 325, you can stop the repetitions encoded into a clip such as an 
animated GIF. 


- fill, erase, fillDefault 


These attributes let you keep an element visible or remove it when it is no 
longer active. See “Setting a Fill” on page 327 and “Specifying a Default 
Fill” on page 334. 


Specifying Time Values 


SMIL provides two methods to specify time values, a shorthand method and a 
“normal play time” method. Both methods provide the same capabilities. 
Although you can use both methods within the same SMIL file, using just one 
method makes authoring SMIL presentations easier. 


Tip: RealOne Player displays a presentation’s elapsed time in 
one-second increments. You can click the time-elapsed field to 
display time values to 1/10th of a second, however. This can 
help you decide what timing values you want to use with a clip. 


Using Shorthand Time Values 


The shorthand method is best suited for specifying short, simple timing 
values such as five seconds, ten minutes, or 1-1/2 hour. As demonstrated in 
the following table, the shorthand markers of h, min, s, and ms provide an easy 
way to designate a timing value for a SMIL element. 


Timing Shorthand Markers and Examples 


Timing Marker Specifies Example Example Value 
h hours end="2.5h” 2 hours, 30 minutes 
min minutes end="2.75min” |2 minutes, 45 seconds 


(Table Page 1 of 2) 
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Timing Shorthand Markers and Examples (continued) 
Timing Marker Specifies Example Example Value 


Tip: Decimal values are not required. You can express two 
seconds as “2s” or “2.0s”, for example. 


15 seconds, 550 milliseconds 


670.2 milliseconds 


(Table Page 2 of 2) 


Using the Normal Play Time Format 


The “normal play time” format for SMIL timing is suited for long, complex 
timing values, such as specifying one hour, fourteen minutes, 36 and 1/2 
seconds. The normal play time format values use the following syntax: 


hh:mmi:ss.xy 
where: 
« hh is hours 
* mm is minutes 
* ss is seconds 
+ x is tenths of seconds 
-y is hundredths of seconds 


Only the ss field is required. When the time value does not include a decimal 
point, the last field is read as the seconds. For example, 1:30 means 1 minute 
and 30 seconds, whereas 1:30:00 means 1 hour and 30 minutes. Note that all 
of the following values are equivalent to 90 minutes: 

begin="1:30:00.0" 

begin="90:00” 

begin="5400” 


Setting Begin and End Times 


The begin and end attributes affect when an element starts or stops, 
respectively. This section explains how to use begin and end with the basic 
SMIL timing values. Chapter 14 describes advanced timing values that you can 
use with begin and end to add interactivity to a presentation. 
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Using a Begin Time with a Clip 


Using an 


Using the begin attribute, you can vary the point at which a clip starts to play 
back within the presentation timeline: 


<video src="videol.rm” begin="20.5s”/> 


Were the preceding clip in a <par> or <excl> group, it would start playing at 
20.5 seconds after the group became active. The begin attribute thereby lets 
you stagger the starting times of clips contained in these groups. Were this 
clip in a <seq> group, there would be 20.5 seconds of blank time before the clip 
starts. The begin attribute therefore lets you insert delays into sequences. 


For More Information: See also “Setting a Fill with Sequential 
Clips” on page 329 


End Time with a Clip 


You can set an end attribute alone or in combination with a begin attribute as 
shown in the example below, which sets the clip to end at 62.7 seconds into its 
part of the presentation timeline: 


<video src="videol.rm” begin="20.5s” end="62.7s"/> 


Note that the end time is measured from the point where the clip would start 
if no begin time were set. To calculate how long the clip is active, subtract the 
begin value from the end value. In the preceding example, the clip is active a 
total of 42.2 seconds (62.7 minus 20.5) regardless of the length of its internal 
timeline. If the clip’s timeline were shorter than 42.2 seconds, the clip’s last 
frame would display until the full 42.2 seconds had elapsed. 


Tip: The dur attribute gives you an alternative and sometimes 
simpler way to specify how long an element plays. For more 
information, see “Setting Durations” on page 317 


Using Begin and End Times with Groups 


In group tags, the begin and end attributes function much as they do in clip 
tags: 
+ Ifa <seq>, <par>, or <excl> group is part of a larger sequence, a begin 
attribute inserts “blank time” before the group becomes active. During 


this blank time, RealOne Player is not paused, but no activity occurs 
onscreen. 
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+ Ifa <seq>, <par>, or <excl> group is contained in a larger <par> group, a 
begin value delays when the group becomes active relative to other 
elements in the larger <par> group. 


If a <seq>, <par>, or <excl> group is contained in a larger <excl> group, a 
begin value determines when it becomes active within the <excl> group. 


An end attribute in a <seq>, <par>, or <excl> group determines when the 
group, and hence all clips in the group, stop playing. The following 
example shows a parallel group within a larger sequence. The <par> group 
has both a begin and an end attribute: 
<seq> 

...preceding elements in the sequence... 

<par begin=“5s” end="3.5min”> 

...clips in the parallel group... 

</par> 

...following elements in the sequence... 
</seq> 
In this example, the begin value delays group playback until 5 seconds 
after the preceding element in the sequence stops. The end attribute stops 
all clips in the <par> group after 3.5 minutes, regardless of their playback 
states. If all clips conclude before that time, there will be blank playback 
time before the next element in the sequence starts. 


Setting Internal Clip Begin and End Times 
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The clipBegin and clipEnd attributes specify a clip’s internal timing marks 
where playback begins and ends. They allow you to play just part of a clip that 
has an internal timeline, such as an audio, video, or animation clip. They have 
no effect on groups or static clips such as still images, though. The following 
example uses clipBegin and clipEnd with a video clip: 


<video src="videol.rm” clipBegin="10s” clipEnd="50s” /> 


Here, the clip starts playing at its internal 10-second mark rather than at its 
encoded beginning. It stops when it reaches its 50-second mark, having played 
for a total of 40 seconds. 


Warning! Do not use clipBegin and clipEnd for a live broadcast 
or when delivering clips with a Web server. For more 
information, see “Limitations on Web Server Playback” on 
page 524. 


CHAPTER 13: Basic Timing 


Combining clipBegin and clipEnd with begin and end 


You can combine clipBegin and clipEnd attributes with begin and end 
attributes. In the following sample, a begin time is added to the preceding 
example: 


<video src="video1.rm” clipBegin="10s” clipEnd="50s” begin="5s"/> 


The begin time delays the clip’s normal starting point by 5 seconds. When this 
time elapses, the clip starts at its 10-second internal timeline marker and plays 
for 40 seconds, which takes it to the 50-second mark of its internal timeline. 
In this case, the clipEnd attribute determines how long the video is active. You 
could also add an end attribute to modify this behavior, as shown in the 
following example: 


<video src="video1.rm” clipBegin="10s” clipEnd="50s” begin="5s"” end="50s” /> 


Combined with the begin value, the end value of 50 means that the clip’s 
“window of activity” within the presentation is 45 seconds. Because the clip 
stops playing after 40 seconds, there is an extra 5 seconds during which the 
clip does not play but remains active and frozen onscreen. In contrast, if you 
used end="30", the begin and end values would set a playback time of 25 
seconds, overriding the specified clipEnd time. 


Setting Durations 


The dur attribute controls how long an element stays active after it starts to 
play. The following example ends the video after 85 seconds, regardless of the 
length of the clip’s internal timeline. If the video’s timeline is shorter than 85 
seconds, the video’s last frame appears frozen onscreen until the duration 
elapses: 

<video src="videol.rm” dur="85s”"/> 


A common use of dur is to control how long a static clip such as an image 
appears onscreen. Because a static clip has an intrinsic duration of zero 
seconds, using dur is the easiest way to set the clip’s playback time. The 
following example displays an image for two minutes: 


<img src=“button1.gif” dur="2min”/> 


Choosing end or dur 


In the preceding example, end="2min” would achieve the same result as 
dur=“2min” because no begin time is used. When a begin attribute is present, 
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you need to calculate the end value relative to the begin value. With a dur 
attribute, however, you just set the total duration you want. This makes dur 
easier to use in some cases. 


For example, suppose that you want a video to play for exactly two minutes. If 
a begin="20.5s” value delays the video playback for 20.5 seconds, you have to 
calculate the end value by adding the begin value to the total playback time you 
want, as shown in the following example (140.5 - 20.5 = 120 seconds): 


<video src="videol.rm” begin="20.5s” end="140.5s"/> 

With a dur attribute, on the other hand, you just specify the total playback 
time, as shown here: 

<video src="videol.rm” begin="20.5s" dur="2min” /> 

As the preceding examples illustrate, you can use either end or dur depending 
on how you want to measure time for clip playback. For most simple timing 


needs, you use either end or dur, but not both. If an element includes both end 
and dur, the attribute that specifies the shorter playback time is used. 


Setting a Duration for the Length of Media Playback 


Using an 


With clips that have internal timelines, you can use dur=“media” to set the 
clip’s duration to the length of its internal timeline. This is useful only when 
you include another timing value, such as an end attribute. Consider the 
following example: 


<video src="videol.rm” end="10min” dur="media” /> 


Because this clip uses both end and dur, the attribute specifying the shorter 
playback time is used. Suppose the video clip normally runs 15 minutes. In 
this case, end="10min” ends the clip after 10 minutes. But if the clip runs just 5 
minutes, dur=“media” ends the clip when it finishes its normal playback. If you 
did not have dur=“media” in this case, the end="10min” value would keep the 
clip active an additional 5 minutes, unnecessarily lengthening playback. 


Indefinite Duration 


You can use dur=“indefinite” to extend an element’s duration indefinitely. As 
with dur="media”, dur=“indefinite” is typically used with another timing 
attribute that ends the element. For example, the following clip stays active 
indefinitely until the viewer clicks the image with the ID stop: 
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<par> 
<ref src="...” dur="indefinite” end="stop.activateEvent” region="play” /> 
<img src="...” id="stop” dur="10s” fill="freeze” region="stopbutton” /> 
</par> 


When an element has an indefinite duration, RealOne Player’s timeline slider 
does not operate because the presentation’s end time cannot be known in 
advance. Hence, viewers cannot seek through the presentation. The timeline 
slider will work, though, if a group timing attribute overrides the element’s 
indefinite duration. For example, if you added dur="10min” to the <par> tag in 
the preceding example, RealOne Player’s timeline slider would operate and 
indicate a presentation lasting ten minutes. 


For More Information: Chapter 14 explains the advanced timing 
commands that let you end a clip on a certain event, such as 
when another clip is clicked. 


Tips for Setting Durations 


+ Like the end attribute, the dur attribute in a <seq>, <par>, or <excl> tag sets 
an absolute duration for the group. For more information, see “Using 
Begin and End Times with Groups” on page 315. 


+ The dur="“media” and dur=“indefinite” attributes are compatible with a 
clipBegin value. A valid clipEnd value always overrides these durations, 
however. 


+ The repeatCount attribute can play a percentage of an element when you 
don’t know how long the element lasts. For example, you can play half of a 
clip by using repeatCount="0.5” instead of dur. With a three-minute clip, for 
example, repeatCount="0.5" is equivalent to dur="1.5min”. 


For More Information: For more on repeatCount, see “Repeating 
an Element a Certain Number of Times” on page 323. 


+ When you use an image in a <par> or <excl> group, you can pick a simple 
duration, such as dur="5s", and include fill=“freeze” in the source tag. This 
freezes the image until the <par> group ends, or until another element in 
the <excl> group replaces the image. This method is preferred over using 
dur=“indefinite” because the indefinite value can prevent RealOne Player 
from determining how long the entire group lasts. 
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For More Information: For instructions on using the fill 
attribute, See “Setting a Fill” on page 327. 


Setting Minimum and Maximum Times 


This section to be added. 


Ending a Group ona Specific Clip 
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By default, a <par> or <excl> group ends when all elements in the group finish 
playing. You can modify this behavior with the endsync attribute. Suppose a 
long clip of background music plays in parallel with a shorter RealText clip. 
Using endsync, you can stop the group when the RealText clip finishes, cutting 
off the background music once the text has displayed. The endsync attribute 
has no effect in <seq> tags or clip source tags. The following table lists the 
endsync values. 


endsync Attribute Values 


Value Function Reference 
‘all. Endsthe group once all clipshave finished. —~—~—~—~*| page 320 
first Ends the group when the first clip finishes. page 321 
ID Ends the group when a specific clip finishes. page 321 
last Ends the group when the last clip finishes. This is the default. | page 320 


Stopping a Group After the Last Clip Plays 


The two values endsync=“last” and endsyc="all” are similar. Both end a <par> or 
<excl> group when the last clip finishes playing. (Here, “last” refers to playback 
times and not the order that clips are listed in the group.) Because the default 
value is endsync="last”, you do not need to add this value to the group tag 
explicitly. 

In the following example, the group behavior would be the same if you used 
just the <par> tag. Here, the parallel group concludes when the video ends, as 
long as the video plays more than two minutes. If the video has a shorter 
duration, the group ends when the image clip’s two-minute duration expires: 
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<par endsync="last”> 
<video id="vid1" src="videol.rm” region="video_region”/> 
<img src="banner.png” region="banner_region” dur="2min”/> 
</par> 


When all group elements use basic timing values, as in the preceding example, 
endsync="all” functions just like endsync="last”. The difference between these 
values arises only when elements in the group use interactive timing values, 
which are described in Chapter 14. Consider the following example of an 
exclusive group in which each clip plays only when a button is clicked: 
<excl endsync="all”> 

<video src="videol.rm” begin="button1.activateEvent” .../> 

<video src="video2.rm” begin="button2.activateEvent” .../> 


<video src="video3.rm” begin="button3.activateEvent” .../> 
</excl> 


In this case, using a group tag of <excl> or <excl endsync="last”> would not 
work. When this exclusive group starts, no clips are active because playback 
depends on the viewer clicking a button. The default value of endsync="Last” 
immediately ends the group in this case. The endsync="all” value keeps the 
group active until all clips in the group have played, however. In the preceding 
example, the group ends after the viewer has clicked all three buttons to play 
all three videos. 


For More Information: Exclusive groups are described in 
“Creating an Exclusive Group” on page 259. The section 
“Defining a Mouse Event” on page 346 explains the 
activateEvent timing value. 


Stopping the Group When a Specific Clip Finishes 


The values endsync="first” and endsync="ID" can stop a <par> or <excl> group 
when a specific element stops playback. Use endsync="first” to stop the group 
when the first element in the group stops playing. (Note that “first” refers to 
playback times and not the order that elements are listed in the group.) All 
other elements in the group stop playing at that point, regardless of their 
playback statuses or any timing parameters specified for them. 


The attribute endsync=“ID” causes the group to conclude when the designated 
element ends playback. All other elements in the group stop playing at that 
point, regardless of their playback statuses or any timing parameters used 
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with them. The designated element must have a corresponding id value in its 
source tag, as illustrated in the following example: 
<par endsync="vid1"> 
<video id="vid1" src="video1.rm” region="video_region”/> 
<textstream src="moreinfo.rt” region="text_region”/> 
</par> 


Note: Because all, first, last, and media are endsync values, do not 
use these words as clip IDs when using endsync="ID". 


Tips for Using the endsync Attribute 


- A dur or end attribute in a <par> or <excl> tag overrides endsync. In these 
cases, RealOne Player ends the group as specified by the dur or end 
attribute, not the endsync attribute. 


Timing attributes used with the targeted element will affect the group 
ending point. If you use endsync="ID” and select the ID of an element that 
repeats twice, for example, both repetitions must finish before the group 
stops. 


If you repeat the group, each repetition obeys the endsync attribute. 
Suppose that you define the following parallel group: 


<par endsync="first” repeatCount="2"> 


The group stops when the first element stops, then repeats. On the second 
repetition, the group again stops when the first element stops. 


When an element can restart because it has multiple begin times, the 
actual or possible restarts do not affect endsync. Consider the interactive 
example discussed previously: 
<excl endsync="all”> 

<video src="videol.rm” begin="button1.activateEvent” .../> 

<video src="video2.rm” begin="button2.activateEvent” .../> 

<video src="video3.rm” begin="button3.activateEvent” .../> 
</excl> 
By default, each video can restart whenever the viewer clicks the video’s 
start button. The viewer may play video1.rm, then video2.rm, then video1.rm 
again, then video2.rm again. These restarts do not affect the endsync 
attribute. But once the viewer has played each of the three videos at least 
once, the endsync attribute ends the <excl> group, preventing the videos 
from restarting again. 
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For More Information: The restart and restartDefault attributes 
give you more control over restart possibilities. For details, see 
“Controlling Whether an Element Restarts” on page 352. 


Repeating an Element 


Using a repeat attribute, you can specify how many times, or for how long, an 
element repeats. You can also make an element repeat indefinitely. The 
following table summarizes these attributes. 


Repeat Attributes 


Attribute Value Function Reference 


repeatCount | integer|indefinite| | Repeats the clip the specified number | page 323 


fractional_value of times, or indefinitely. 
repeatDur time_value | Repeats the clip the specified amount | page 323 
indefinite of time. 


Repeating an Element a Certain Number of Times 


The repeatCount attribute repeats an element a specific number of times. You 
can use integer values such as 2 or 4 to specify an exact number of repetitions. 
You can also use decimal values to stop the clip during a repetition. In the 
following example, the video plays 3-1/2 times: 


<video src="videol.rm” repeatCount="3.5" /> 


Repeating an Element a Specific Amount of Time 


The repeatDur attribute repeats an element for a specified amount of time. Like 
a begin, end, or dur attribute, the repeatDur attribute uses a standard SMIL 
timing value, as described in “Specifying Time Values” on page 313. When you 
use repeatDur, the element repeats as many times as it can within the specified 
time, shown in the following example as five minutes: 


<video src="videol.rm” repeatDur="5min”/> 


The repeatDur attribute functions like end, so if you include a begin time, the 
total playback time is the repeatDur value minus the begin value. For example, 
the following clip is active within the presentation timeline for five minutes, 
but it does not play during the first minute. Its repeating cycles then last a 
total of four minutes: 


323 


RealNetworks Production Guide 


324 


<video src="videol.rm” begin="1min” repeatDur="5min"/> 


Specifying the Length of Each Repeating Cycle 


A dur attribute included with repeatCount or repeatDur sets the total time that 
must elapse before the element repeats. For example, each repetition of the 
following clip lasts three minutes. Because the clip plays twice, the total 
playing time is six minutes: 


<video src="videol.rm” repeatCount="2” dur="3min"/> 


If the video in the preceding example has an internal timeline longer than 
three minutes, the video stops after three minutes and immediately repeats, 
playing again for just three minutes. If the video runs less than three minutes, 
its last frame appears frozen until the full three minutes have elapsed. 


Setting a Total Playback Time 


An end attribute sets the total playback time during which an element can 
repeat. You can use it with or without dur. For example, the repeatCount, dur, 
and end values in the following tag cause the clip to play one cycle in three 
minutes, repeat, then stop after playing a total of five minutes. This places the 
end of playback at two minutes into the second cycle: 


<video src="videol.rm” repeatCount="2” dur="3min” end="5min”/> 


Looping Playback Indefinitely 


An indefinite value used with a repeatCount or repeatDur attribute causes an 
element to repeat until another timing attribute or user event stops the loop. 
In the following example, the audio clip repeats continuously until the viewer 
clicks the RealOne Player Stop button: 


<audio src="song.rm” repeatCount="indefinite” /> 
As explained in “Specifying the Length of Each Repeating Cycle” on page 324, 


a dur attribute can set the length of each repeating cycle. In the following 
example, each loop lasts 30 seconds: 


<audio src="song.rm” repeatDur="indefinite” dur="30s” /> 
Using the indefinite value for an element in a sequence prevents the sequence 


from ending unless the <seq> tag itself specifies the end time with a dur or end 
attribute. With a <par> group, you can use endsync="ID” to stop the group 
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when an element other than the looping element finishes. In the following 
example, the audio loop stops when the RealPix slideshow concludes: 
<par endsync=" pix”> 
<audio src="background.rm” repeatDur="indefinite” /> 
<ref src="promo.rp” id="pix” region="images_region”/> 
</par> 


For More Information: See “Ending a Group on a Specific Clip” 
on page 320 for more information on endsync. 


Stopping a Clip’s Encoded Repetitions 


For clips such as animated GIF images, you can halt the clip’s native 
repetitions by adding mediaRepeat="strip” to the clip’s source tag: 


<img src="image.gif” dur="20s” mediaRepeat="strip” /> 


Although the mediaRepeat=“strip” attribute stops a clip from repeating, it does 
not necessarily render a clip static. For example, an animated GIF image may 
consist of ten unique frames that play in sequence, with the sequence 
repeating indefinitely. If mediaRepeat="strip” is used, the ten unique frames 
play in sequence once, but do not repeat. 


Once you strip out a clip’s native repetitions, you can use timing attributes to 
set a different pattern of repetition. Suppose that a GIF image shows one 
frame every second for ten seconds, then repeats this cycle indefinitely. To add 
a delay of five seconds between each cycle, you can use the attributes shown in 
the following example: 


<img src="image.gif” mediaRepeat=“strip” dur="15s” repeatDur="indefinite”/> 


In this example, the mediaRepeat attribute strips out the GIF image’s native 
repetitions. The dur attribute sets the repeating cycle to 15 seconds, meaning 
the image animates as normal for 10 seconds, then pauses for five seconds. 
The repeatDur attribute makes this 15-second cycle repeat indefinitely. 


Managing Bandwidth with Repeating Clips 


When you repeat a clip streamed with RTSP or HTTP, each repetition 
consumes bandwidth because RealOne Player does not cache the clip. 
Alternatively, you can use CHTTP to cache a repeating clip on RealOne Player. 
The clip then consumes bandwidth only the first time it plays. You should use 
CHTTP only for small clips, however, because the clip cannot be larger than 
RealOne Player’s cache size of a few Megabytes. 
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For More Information: For more information on using CHTTP, 
see “Caching Clips on RealOne Player” on page 219. 


Leaving Bandwidth Available for Repeating Cycles 


When you stream with RTSP or HTTP, RealOne Player prebuffers each 
repetition to keep the presentation from pausing when the clip replays. The 
presentation therefore needs spare bandwidth for buffering the repeating 
cycles. To determine how much bandwidth to reserve, divide the clip’s preroll 
by the amount of time that the clip plays in each cycle. Next, multiple that 
number by the clip’s streaming bandwidth. 


Suppose that a RealAudio clip streams at 20 Kbps, plays for 60 seconds, and 
requires 8 seconds of prebuffering. The reserve bandwidth is the following: 


((8/60) x 20) = 2.7 Kbps 


The inclusion of the reserve bandwidth sets the total streaming bandwidth 
requirement to 22.7 Kbps. This is OK for 56 Kbps modems, but too high for 
28.8 Kbps modems, which have a 20 Kbps maximum as listed in the table 
“Maximum Streaming Rates” on page 47. 


Tip: To determine how much preroll a clip requires, open the 
clip in RealOne Player, and use View>Clip>Clip Source to view 
the buffering information. 


Helix Universal Server Streams Used with Repeating Clips 


RealOne Player never requests more than two streams for a repeating clip. If 
you use repeatCount="8", for example, RealOne Player requests and plays the 
first stream. As it does so, it prebuffers the second, identical stream. As it plays 
the second stream, it requests the first stream again, prebuffering it for the 
third repetition, and so on. 


Tips for Repeating Elements 


+ Keep in mind that when an element does not repeat, end and dur both 
specify the clip’s playing time, with the shorter value used. When an 
element includes repeatDur or repeatCount, though, end and dur have 
different functions. The end attribute sets the total time for all repetitions, 
whereas the dur attribute sets the length of each repeating cycle. 
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+ With the indefinite value (and only the indefinite value), repeatCount and 
repeatDur function identically. Therefore, it doesn’t matter if you use 
repeatCount="indefinite” or repeatDur="indefinite”. 


- A decimal value for repeatCount is useful for playing just part of an element 
when you don’t know how long the element lasts. For example, you can 
play half of any clip by using repeatCount="0.5". With a three-minute clip, 
for example, repeatCount="0.5”" is equivalent to dur="1.5min”. 


+ You can use the clipBegin and clipEnd attributes, described in “Setting 
Internal Clip Begin and End Times” on page 316, with repeating clips. 


+ When you embed a SMIL presentation in a Web page, you can use the 
<EMBED> tag’s LOOP or NUMLOOP parameter to repeat the entire 
presentation. For more information, see “Setting Automatic Playback” on 
page 500. 


Setting a Fill 


When an element ends but is not immediately replaced by another element, 
you can use the fill attribute to specify whether the element disappears or 
remains onscreen. Useful primarily with visual clips and elements such as 
SMIL animations, the fill attribute does not affect audio-only clips. The 
following table summarizes the fill attribute values. 


fill Attribute Values 


Value Function Reference 
auto Makes fill behavior depend on timing attributes. page 328 
default Lets fillDefault control the fill behavior. page 334 
freeze Freezes element when it finishes. page 329 
hold Keeps element visible until the group ends. page 329 
remove Makes element disappear when it finishes. page 329 
transition | Freezes clip long enough for a transition effect to occur. _| page 412 

This is used only with clips, and not with group tags. 

Chapter 16 explains the transition value. 


The fill action comes after the clip’s end time, as set by its internal timeline, or 
as specified by any timing values such as dur, end, repeatCount, or repeatDur. 
Consider the following example: 
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<par> 
<ref src=...” id="clip_1” region="region_1” dur="3min” fill="...”/> 
<ref src=...” id="clip_2” region="region_2” dur="5min"/> 

</par> 


The dur="3min” attribute keeps the first clip active exactly three minutes, 
regardless of the length of its internal timeline. The fill attribute takes effect 
when this duration elapses. Suppose the fill attribute freezes the clip onscreen. 
Because the second clip’s duration makes the entire <par> group last five 
minutes, the first clip freezes for two minutes past its duration. The following 
figure illustrates this fill period. 


Fill Period for Two Clips in a Parallel Group 


dur="3min" fill="..." 
se re 


mT 


dur="5min" 
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Using an Automatic Fill 


If you do not use a fill attribute with an element, and you do not set a 
fillDefault value in a group that contains the element, the element behaves as if 
fill=“auto” is set. (You can also set fill=“auto” explicitly.) The effect of the auto 
value depends on whether certain timing elements are used: 


+ If the element includes a dur, end, repeatCount or repeatDur timing attribute, 
the fill=“auto” value is equivalent to fill=“remove”. For example, a video that 
uses a dur attribute disappears when the duration expires. 


- If the clip does not include any of these timing attributes, the fill=“auto” 
value is equivalent to fill="freeze”. For example, the final frame of a video 
that does not use any SMIL timing values freezes until the group that 
contains the clip ends. 
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For More Information: The following sections explain how 
fill="remove” and fill="freeze” attributes affect clips in different 
types of groups. For more on fillDefault, see “Specifying a 
Default Fill” on page 334. 


Setting a Fill with Sequential Clips 


In a sequence of clips, a clip automatically disappears when it ends, so each 
clip already behaves as if it has a fill=“remove” attribute. The fill=“freeze” value 
affects a clip in a sequence only if the subsequent clip has a delayed start. In 
the following example, the second clip’s begin time inserts a five-second delay 
before it plays. The fill="freeze” value keeps the first clip visible during the 
delay: 
<seq> 

<video src="videol.rm” region="video_region” fill="freeze” /> 

<video src="video2.rm” region="video_region” begin="5s”"/> 
</seq> 


A fill=“hold” value displays a clip until the sequence ends. In the following 
example, an image used as a background displays first. Next, a RealText clip 
and video play in parallel in front of the image. Without the hold value, the 
image would disappear as soon as its duration elapsed. But the hold value 
keeps the clip visible until the entire sequence ends: 
<seq> 
<img src="logo.gif” region="bg_region” dur="1s” fill="hold” /> 
<par> 
<textstream src="titles.rt” region="text_region” fill="freeze” /> 
<video src="videol.rm” region="video_region”/> 
</par> 
</seq> 
For the last clip in a sequence, fill=“freeze” and fill=“hold” function similarly. 
They have an effect only if the <seq> tag has a dur or end value that keeps it 
active after all clips have played. If all clips finish playing after eight minutes, 
but the <seq> tag has a dur="10min” attribute, for instance, a fill=“freeze” or 
fill=“hold” attribute for the last clip keeps that clip visible for the final two 
minutes of the sequence. 
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Setting a Fill in Parallel Groups 


Use fill="remove” with a clip in a <par> group to make the clip disappear when 
it finishes playing. In the following example, the RealText clip disappears as 
soon as it finishes playing. Assuming that the video clip has a longer timeline, 
the parallel group ends when the video finishes playing: 
<par> 

<textstream src="titles.rt” region="text_region” fill="remove” /> 

<video src="videol.rm” region="video_region”/> 
</par> 


In a <par> group, fill="freeze” and fill=“hold” both keep a clip visible until the 
group completes. In the following example, the final text block of the RealText 
clip stays visible when the clip finishes playing. Assuming that the video clip 
has a longer timeline, the parallel group ends with the video clip: 
<par> 

<textstream src="titles.rt” region="text_region” fill="freeze” /> 

<video src="videol.rm” region="video_region”/> 
</par> 


Setting a Fill in Exclusive Groups 


Use fill="remove” on a clip in an <excl> group to make the clip disappear when 
it finishes playing. In the following example, each video clip disappears as 
soon as it finishes playing. If a clip finishes playing before another clip 
becomes active, no clip is visible on the screen: 


<excl> 
<video src="videol.rm” region="video_region” begin="...” fill="remove” /> 
<video src="video2.rm” region="video_region” begin=”"...” fill="remove” /> 
</excl> 


Use fill="freeze” to keep a clip in an <excl> group visible until another clip in 
the group plays. Use fill="hold” to keep the clip visible until the entire <excl> 

group concludes. In this case, each opaque clip needs to display in a separate 
region to prevent other clips from obscuring it. 


Displaying a Clip Throughout a Presentation 


The attribute fill=“hold” keeps a clip visible only until the group that contains 
it ends. You can add erase=“never” to fill=“hold” to keep a clip visible for the 
entire presentation, and even after the presentation has ended. This feature, 
which does not work in group tags, is useful for adding a background to a 
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presentation that contains any number of groups, as shown in the following 
example: 
<body> 
<seq> 
<img src="Llogo.gif” region="bg_region” dur="1s” fill="hold” erase="never” /> 
...other groups and clips... 
</seq> 
</body> 


In the preceding example, the background clip is listed as the first element in 
a sequence that contains other clips and groups. The fill and erase values keep 
the background clip visible while the subsequent clips and groups play. 


Summary of Common Clip fill Values 


Although the fill attribute can be used for groups and other elements such as 
SMIL animations, the most common use is with clips inside of groups. The 
following table summarizes how the most commonly used fill values affect 
clips that display in <seq>, <par>, and <excl> groups. 


fill Attribute Values for Clips in <seq>, <par>, and <excl> Groups 


Clip Attributes Group Function 


<seq> | Clip disappears when it stops playing. 


fill-”remove” <par> | Clip disappears when it stops playing. 


<excl> | Clip disappears when it stops playing. 


<seq> | Clip freezes after playback only for the duration of the 
subsequent clip’s begin value, such as begin="5s”. 


Fie hens <par> | Clip freezes until the entire <par> group concludes. 


<excl> | Clip freezes until another clip in the <excl> group plays. 


<seq> | Clip freezes until the entire <seq> group concludes. 
P group 


<par> | Clip freezes until the entire <par> group concludes. 


Eemold Identical to fill="freeze”. 
<excl> | Clip freezes until the entire <excl> group concludes. 
<seq> | Clip displays throughout the presentation. 
fill="hold” 


i i <par> | Clip displays throughout the presentation. 
erase= never P P prey & P 


<excl> | Clip displays throughout the presentation. 
(Table Page 1 of 2) 
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fill Attribute Values for Clips in <seq>, <par>, and <excl> Groups (continued) 


Clip Attributes Group Function 


Clip freezes long enough for the transition effect to occur. 


ee .,.._, |<par> | Clip freezes long enough for the transition effect to occur. 
fill="transition P P 8 8 


<excl> | Clip freezes until another clip in the group plays, then 
remains long enough for the transition effect to occur. 
(Table Page 2 of 2) 


For More Information: See “Using Clip Fills with Transition 
Effects” on page 412 for more information on fill="transition”. 


Setting a Group Fill 


You can also use a fill attribute with a value of remove, freeze, or hold in a group 
tag. Consider the following example, in which album credits and cover art 
display before a song plays: 
<seq> 
<par fill="hold”> 
<img src="cover.jpg” id="clip1” region="art_region” dur="20s” fill="freeze” /> 
<textstream src="credits.rt” id="clip2” dur="60s” region="credits_region”/> 


</par> 
<audio src="song1.rm” id="clip3” dur="80s” /> 
</seq> 


In this example, the fill=“freeze” value for the JPEG album cover keeps that clip 
visible as long as the <par> group is active. The <par> group itself has a 
fill=“hold” value that keeps its final state visible until the containing <seq> 
group finishes. In other words, the <par> group’s fill=“hold” value extends the 
first two clips’ fill periods until the <seq> group ends. The result is that the 
credits and cover image remain visible until the song completes, as the 
following illustration shows. 
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Clip Fill Periods Extended by a Group Fill 
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Tip: To set a fill value for a group and pass that value onto the 
elements in the group, use fillDefault instead of fill in the group 
tag. 


Tips for Setting a Fill 


- By default, a clip acts as if fill=“freeze” is set unless the clip tag contains a 
dur, end, repeatCount or repeatDur attribute. In tags where a dur, end, 
repeatCount or repeatDur attribute is present, the clip acts as if fill="remove” 
is set. Setting a fill value explicitly, though, always overrides the default. 


In a<par> group only, you can use erase="never” with fill="freeze” to display 
a clip throughout the entire presentation. Because fill=“hold” along with 
erase="never” does the same for clips in any type of group, however, it is 
easier always to use this latter combination. 


Using the dur attribute along with fill=“remove” is the simplest means for 
setting how long a graphic image, which has no internal timeline, appears 
onscreen. In the following example, the image disappears 14.5 seconds 
after it appears: 


<img src="poster.jpg” dur="14.5s” fille“remove” /> 
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- Using a short dur value along with fill="freeze” is the most common 
method for displaying a graphic image for as long as a parallel group is 
active: 
<par> 

<img src="poster.jpg” dur="2s” fill=“freeze” /> 
...other elements in the parallel group... 
</par> 

- As long as a clip appears onscreen, any hyperlink defined for it remains 
active, unless the hyperlink is specifically deactivated at an earlier point. If 
a video links to a Web page, for example, the Web page still opens if the 
viewer clicks the link after the video has stopped playing and appears 
frozen onscreen. For more on linking, see Chapter 15. 


+ In SMIL 2.0, the fill attribute works slightly differently than it does in 
earlier versions of RealPlayer that supported SMIL 1.0. For more 
information, see “Behavioral Changes” on page 206. 


Specifying a Default Fill 


You can use the fillDefault attribute in a group tag to set a fill value for that 
group and its elements, whether those elements are clips or other groups. All 
elements within the group receive the default fill value unless they have 
another fill value explicitly set. The following table lists the possible fillDefault 


values. 
fillDefault Attribute Values 
Attribute Function Reference 
auto Makes fill behavior depend on timing attributes. page 328 
freeze Freezes elements in the group when they finish playing. page 329 
hold Freezes elements in the group until the group ends. page 329 
inherit Makes each element inherit the fillDefault setting from the | page 335 
containing group. This is the default value. 
remove Makes elements in the group disappear when finished. page 329 
transition | Freezes clips in the group long enough for a transition effect | page 412 
to occur. Chapter 16 explains the transition value. 


Adding a Default Fill to a Group 


The following are the general rules for using fillDefault in a group tag: 
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+ Ifa fillDefault value is set in a clip’s group tag, and no fill value is set for 
the clip, the clip uses the group’s fillDefault value. 


+ Setting a fill value explicitly in a clip source tag always makes the clip use 
that value regardless of any fillDefault setting in the group tag. 


- A group that does not have a fillDefault value explicitly set will inherit the 
fillDefault value from a larger group that contains it. 


The next example illustrates the fillDefault attribute set in a <par> group, with 
some of the group elements overriding the attribute value: 
<par fillDefault=”"freeze”> 
<img src="logo.gif” region="bg_region” dur="1s"/> 
<video src="videol.rm” region="video_region” fill="default” /> 
<textstream src="titles.rt” region="text_region” fill="remove” /> 
</par> 


The following fill actions occur in this group: 


+ The <par> group’s fillDefault=“freeze” value sets its fill value to freeze, and 
passes this value along to all its elements. 


+ The <img/> tag does not include a fill attribute, so it receives a fill=“freeze” 
value from the <par> tag. 


+ The <video/> tag’s fill=“default” attribute makes it receive the freeze value 
just like the <img/> tag. In other words, fill=“default” is the default value 
used with the containing group has a fillDefault attribute. (The attribute 
fill= “auto” is the default value if no fillDefault attribute is used.) Thus, 


setting fill=“default” explicitly has the same effect as leaving fill out of the 
tag altogether. 


+ The <textstream/> tag includes a fill=“remove” attribute, which overrides 
the fill="freeze” value it receives from the <par> tag. 
Inheriting a Default Fill from a Containing Group 


A group that does not have a fillDefault value explicitly set for it automatically 
inherits the fillDefault value of its containing group. The following example 
illustrates this inheritance with a master <par> group that contains three other 
<par> groups as its elements: 
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<par id="master_group” fillDefault="freeze”> 
<par id="group_X”> 
...clips in group_X... 
</par> 
<par id="group_Y” fillDefault=“inherit”> 
...clips in group_Y... 
</par> 
<par id="group_Z” fillDefault="“remove”> 
...clips in group_Z... 
</par> 
</par> 
The following fill actions occur in this set of nested groups: 


+ The fillDefault="freeze” value for master_group sets the group’s fill value to 
freeze, passing this value to all group elements. 


7 


* group_X does not include a fillDefault attribute, so it receives a fill="freeze’ 
value from the <par> tag. 


+ The fillDefault="inherit” attribute in group_Y makes this group receive the 
freeze value from the master group. In other words, fillDefault=“inherit” is 
the default value used with a group when its containing group has a 
fillDefault attribute. Setting fillDefault="inherit” explicitly has the same 
effect as leaving fillDefault out of the tag altogether. 


+ group_Z includes a fill=“remove” attribute, which overrides the 
fillDefault="freeze” value it receives from the master group. This group 
uses the freeze value, passing it to all the elements it contains. 
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ADVANCED TIMING 


Once you have mastered the basic timing attributes described in 
Chapter 13, you are ready to tackle SMIL’s advanced timing features. 
Using these features, you can develop interactive presentations that 
play clips when viewers click icons, for example. You can also use 
advanced timing to create effects similar to those found in Web 
pages, such as starting a SMIL animation when the viewer moves the 


screen pointer over an image. 


Tip: Be sure to familiarize yourself with “Conventions Used in 
this Guide” on page 13. That section lists the typographical 
conventions used in this chapter to explain event timing 
syntax. 


Understanding Advanced Timing 


Chapter 13 explains the basic timing attributes: begin, end, and dur. Although 
this chapter introduces some new timing attributes, it primarily shows you 
how to expand the power of the begin and end attributes through complex 
timing values. This chapter describes many different ways to start or stop an 
element besides using basic timing attributes such as begin="5s". 


Advanced Timing Syntax 


The key to advanced SMIL timing is the event. Although not always the case, 
an advanced timing command typically starts or stops a SMIL element (or 
multiple SMIL elements) when an event occurs. So you generally have two 
elements that you work with: the element that triggers the event, and the 
element (or elements) that the triggered event starts or stops. For the element 
that provides the event trigger, you must define an ID: 


<element_tag1 id="ID” .../> 
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In the triggered element’s tag, you create a begin or end value that refers to the 
first element’s ID, specifies the triggering event, and, optionally, adds a timing 
offset: 


<element_tag2 begin|end="ID.event[+|-time_value]” .../> 


To make these abstract examples more concrete, suppose that your triggering 
element is a video clip: 


<video src=“videol.rm” id="intro” region="video_region”/> 


Your triggered element might be a graphic image that begins 10 seconds after 
the video starts: 


<img src=“picture.jpg” begin="intro.begin+10s” region="image_region” .../> 


In simple cases, advanced timing commands may not be needed. If the two 
preceding clips were in the same <par> group, for example, you could achieve 
the desired 10-second delay with simple timing commands: 
<par> 

<video src=“videol.rm” id="intro” region="video_region”/> 

<img src=“picture.jpg” region="img_region” begin="10s” .../> 
</par> 
The advanced timing commands let you tie elements together when they are 


not in the same group, however. As well, the advanced timing commands let 
you start or stop clips on many kinds of events, such as mouseclicks. 


Event Types 


Events that can start or stop an element fall into two categories: 
- scheduled events 


RealOne Player can determine that a scheduled event will happen before 
the event occurs. The end of a certain clip’s playback is a scheduled event, 
for example, because RealOne Player can determine when the clip will stop 
based on the clip’s internal timeline and the presence of SMIL timing 
attributes. 


interactive events 


Interactive events let you base SMIL actions on user input. But unlike a 
scheduled event, an interactive event such as a mouseclick cannot be 
known before it occurs. Some interactive events mirror scheduled events, 
too. The end of a clip’s playback can trigger an interactive or a scheduled 
event, for instance. 
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The following table summarizes the event values you can use with the begin 


and end attributes. Most event values require an ID value that identifies the 


element that triggers the event. 


begin and end Attribute Event Values 


Value Event Type Event Trigger Reference 
accesskey(key) interactive | keypress page 349 
ID.activateEvent interactive | mouseclick page 346 
ID.begin scheduled beginning of element page 342 
ID.beginEvent interactive | beginning of element page 342 
ID.end scheduled _| end of element page 342 
ID.endEvent interactive | end of element page 342 
ID.focusInEvent interactive | keyboard focus on element page 349 
ID.focusOutEvent interactive | keyboard focus off element page 349 
ID.inBoundsEvent interactive | pointer moving over element page 346 
ID.marker(name) scheduled | marker reached for element page 352 
ID.outOfBoundsEvent interactive | pointer moving off element page 346 
ID.repeat(integer) scheduled _| specific iteration of element page 344 
ID.repeatEvent interactive | each iteration of element page 344 
ID.topLayoutCloseEvent |interactive | secondary media playback page 351 
or scheduled | window closing 
ID.topLayoutOpenEvent | interactive | secondary media playback page 351 
or scheduled | window opening 
ID.wallclock(time) scheduled external clock value reached page 352 


Positive Offset Times 


Most of the begin and end attribute values described in this chapter can take a 


positive offset timing value, which adds a delay between an event and the 


action that the event triggers. For example, a begin attribute might have the 


following syntax, which sets the element to start at five seconds after the event 


(left unspecified here) occurs: 


begin="ID.event+5s” 
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Interactive Events with Positive Offset Times 


A positive offset is useful when starting a clip based on an interactive event. 
Because it cannot anticipate interactive events, RealOne Player does not 
request clips from the server until the interactive event occurs. If you do not 
add a positive offset, RealOne Player may need to pause the presentation while 
it requests and buffers the clip’s preroll. An offset such as +15s, on the other 
hand, enables RealOne Player to request the clip when the event occurs, then 
buffer the clip for up to 15 seconds before playing it. 


Tip: Instead of using a timing offset value, you can use 
<prefetch/> to request a clip’s preroll in advance. For more 
information, see Chapter 19. 


How Much of a Positive Offset Do You Need? 

If you plan to start a clip on an interactive event, open the clip in RealOne 
Player, and use View>Clip>Clip Source to display the buffering information. 
You'll also need to add a few seconds for RealOne Player to request the clip 
from the server, and to begin receiving the streamed data. If a clip’s preroll is 
10 seconds, for example, you may want to use positive offset of 15 seconds to 
ensure that the clip’s preroll has streamed to RealOne Player by the time the 
clip begins to play. 


Note: Static clips such as images do not have a preroll. RealOne 
Player must receive all the clip data before playing the clip. The 
time required to display the clip is the clip size divided by the 
available streaming bandwidth. 


Interactive Events that Do Not Require Positive Offsets 

A positive offset value isn’t necessary when starting or stopping elements on 
interactive events if those elements do not need to be streamed from a server. 
For example, you can use an interactive event such as a mouseclick to trigger a 
SMIL animation that shrinks a clip already received by RealOne Player. 
Because the SMIL animation is defined within the SMIL file, RealOne Player 
has all the data it needs to start the animation when the event occurs. 


Scheduled Events with Positive Offset Times 


When you start clips on scheduled events, a positive offset time is generally 
not required to keep the presentation flowing smoothly. RealOne Player can 
anticipate scheduled events and request a new clip’s preroll far enough in 
advance to prevent presentation rebuffering. You may want to use positive 
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offset times with scheduled events to manage the presentation timeline, 
though. You might want to start a clip five seconds after another clip repeats 
for the second time, for example. You can do that easily by adding +5s to the 
clip’s begin time. 


Negative Offset Times 


SMIL elements within a <par> or <excl> group (but not a <seq> group) can use 
negative timing offsets with advanced begin and end values. You can also use a 
negative offset value with an event, as shown in the following example: 


begin="ID.event-5s” 


Simple Negative Offset Times 


You can use negative timing offsets in basic begin and end attributes, as well as 
with advanced timing commands. In the following example, the video is set to 
begin one minute before the group becomes active: 
<par> 

<textstream src="credits.rt” id="credits” region="credits_region” /> 

<video src=“videol.rm” region="video_region” begin="-1min” /> 
</par> 


Although the negative offset time in the preceding example is valid, a clip 
never plays before the group that contains it becomes active. This is because 
all timing attributes are relative to the group that contains the timed element. 
Instead of making the video clip play one minute before the parallel group 
becomes active, the negative offset shown above functions like clipBegin. This 
means that the video starts playing at its one-minute mark once the group 
becomes active. 


For More Information: The clipBegin attribute is described in 
“Setting Internal Clip Begin and End Times” on page 316. 


Interactive Events with Negative Offset Times 


Because RealOne Player cannot anticipate an interactive event, there is no way 
to use a negative offset time to make a clip start or stop before an interactive 
event happens. If you use a negative offset to start a clip 20 seconds before an 
interactive event occurs, the clip begins when the event occurs, yet appears to 
have played for 20 seconds already. In other words, the clip acts as if 
clipBegin="20s” were included in its source tag. 
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Scheduled Events with Negative Offset Times 


Negative offset values are most useful with scheduled events because RealOne 
Player can determine when scheduled events will occur. RealOne Player can 
determine when a clip is scheduled to end, for instance. You can therefore use 
a negative offset time to end a clip ten seconds before another clip’s scheduled 
end time, for example. 


Multiple Timing Values 


For any SMIL element that uses begin or end attributes, you can define any 
number of timing values by separating the values with semicolons: 


“time1; time2; time3;...” 


In the following example, the clip begins when the first of two possible events 
occurs: either one minute elapses after the clip’s group becomes active, or 
event1 occurs. The clip ends either two minutes after the group starts, or when 
event2 occurs: 


<ref src=...” begin=“1min; event1” end=“2min; event2” /> 


Tips for Specifying Multiple Time Values 


+ The order that you list time values does not matter. The time value listed 
third can occur before the time value listed second or first, for example. 


- The entire value string must be enclosed in double quotation marks. 


+ You can include spaces before or after a semicolon that separates time 
values, but spaces are not necessary. 


¢ Do not add a semicolon after the last value. 


+ The restart attribute can prevent a clip or group from restarting due to 
multiple begin values. See “Controlling Whether an Element Restarts” on 
page 352 for more information. 


Defining an Element Start or Stop Event 


The following four event values work with either the begin or the end attribute, 
letting you start or stop an element when another element begins or ends: 
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- ID.begin[+|-time_value] 


This scheduled event occurs when the element with the given ID begins, 
plus or minus any offset time. If the element repeats, this event does not 
occur at the start of any repeated cycles. 


¢ ID.beginEvent[+|-time_value] 


This interactive event occurs when the element with the given ID begins, 
plus or minus any offset time. If the element repeats, this event occurs 
only on the first iteration. 


¢ ID.end[+|-time_value] 


This scheduled event occurs when the element with the given ID ends, 
plus or minus any offset time. If the element repeats, this event occurs at 
the end of all repeated cycles. This event does not occur if, for example, a 
user action stops the element before its scheduled end time. 


- ID.endEvent[+|-time_value] 


This interactive event occurs when the element with the given ID ends, 
plus or minus any offset time. If the element repeats, this event occurs at 
the end of all repeated cycles. This event will not occur if the viewer stops 
the element by clicking the RealOne Player Stop button. 


Sample Values 


Example 


The following are samples of begin and end values that start or stop an event 
relative to an element with a certain ID value: 


begin="ID.end” Start the element when the element with the given ID 


is scheduled to end. 


end=“ID.begin-5s” Stop the element five seconds before the element with 


the given ID is scheduled to begin. 


begin="ID.beginEvent+5s” Start the element five seconds after the element with 


the given ID actually begins. 


end=“ID.endEvent” Stop the element when the element with the given ID 


actually ends. 


As an example of using a begin event, suppose you want to start a clip two 
seconds after another clip begins. You first add an ID to the element that 
provides the basis for starting or stopping the second element: 
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<video src=“videol.rm” id="intro” region="video_region”/> 


Next, you define the begin or end time for the second element, using the ID of 
the first element: 


<img src=“picture.jpg” region="img_region” dur="20s” begin="intro.begin+2s” /> 


Keep in mind that SMIL timing values can affect when your second element 
begins. Suppose that the video in the preceding example has an internal 
timeline of two minutes, but you specify a three-minute duration as shown 
here: 


<video src=“videol.rm” id="intro” region="video_region” dur="3min”/> 


If the second element uses begin=“intro.end” or begin=“intro.endEvent”, for 
example, it will start to play when the video’s dur time expires, which is one 
minute after the video displays its last frame. 


Defining a Repeat Event 


Two event timing values for the begin and end attributes let you start or stop a 
clip or group when another element repeats. You might target a specific 
iteration, such as the third time the element repeats. Or, you can restart the 
clip or group on each of the element’s repeating cycles: 
- ID.repeat(n)[+|-time_value] 
This scheduled event occurs when the element with the given ID starts its 
specified repeating cycle, plus or minus any offset time. For example, 


ID.repeat(1) specifies the first iteration after the element has already 
played once. 


- ID.repeatEvent[+|-time_value] 
This interactive event occurs when the element with the given ID starts its 
second, and any subsequent, iterations. Note that if an element repeats 
four times, for example, ID.beginEvent occurs when the element first plays, 
and an ID.repeatEvent event occurs at the start of each of the subsequent 
three iterations. 


The repeatEvent and repeat(n) events typically occur when an element uses an 
attribute such as repeatDur and repeatCount, which are described in “Repeating 
an Element” on page 323. They do not occur on these conditions: 


+ The element repeats because it has multiple begin times, as described in 
“Multiple Timing Values” on page 342. 
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+ ArepeatDur or repeatCount attribute causes a group that contains the 
element to repeat. In this case, the repeat events occur for the group, but 
not the individual elements that the group contains. 


Sample Values 


Example 


The following are samples of begin and end values that start or stop an element 
relative to the repetitions of another element: 


begin="ID.repeat(3)” Start the element when the element with the given ID 
begins its third repetition (that is, when it starts to play 
for the fourth time). 


end="ID.repeat(2)-5s” Stop the element five seconds before the element with 
the given ID begins its second repetition. 


begin=“ID.repeatEvent+10s” Start the element ten seconds after the second and each 
subsequent time the element with the given ID repeats. 


To use a repeat timing value, you first add an ID to the clip that will provide 
the basis for starting or stopping the second clip. This clip must also have a 
repeatCount or repeatDur attribute that causes it to repeat. In the following 
example, the video clip repeats three times: 


<video src=“videol.rm” id="main” repeatCount="3” region="video_region”/> 
Next, you define the begin or end time for the second clip, using the ID of the 
first clip. In the following example, the image clip begins when the video clip 


with the ID of main starts its second repetition (that is, when it starts to play 
for the third time): 


<img src=“picture.jpg” region="img_region” dur="20s” begin="main.repeat(2)”/> 


For More Information: For details on the repeatCount and 
repeatDur attributes, see “Repeating an Element” on page 323. 


Note: If an element repeats and has a negative timing offset, 
only the first cycle shows the effect of a clipBegin. All 
subsequent cycles play for their full duration. 
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Defining a Mouse Event 
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Starting or stopping an clip when a viewer clicks another clip is a common 
means of adding interactivity to a streaming presentation. You can also start 
or stop an element such as an animation when the viewer moves the screen 
pointer on of off a clip. The following are the mouse-related event values that 
you can use with a begin or end attribute: 


- ID.activateEvent[+|-time_value] 
This interactive event occurs when the viewer clicks on the clip with the 
specified ID. The target ID must be that of a clip, not a group or a region. 
A “click” means a single press and release of the screen pointing device, 
typically the mouse. SMIL does not provide separate events for the 
individual press (“mousedown”) and release (“mouseup”) actions. 


Note: The clip will not register the click if the clip is rendered 
more than 50 percent transparent with a value from 0 to 50 for 
rm:mediaOpacity. See “Adding Transparency to All Opaque 
Colors” on page 223 for more information on this attribute. 


ID.inBoundsEvent[+|-time_value] 

This interactive event occurs when the viewer moves the screen pointer 
over the clip. The “in bounds” area is the part of the clip that displays in 
the region. Portions of the clip cut off at the region boundaries are not 
affected. The event occurs even if the clip has finished playing and appears 
frozen onscreen. The target ID must be that of a clip, not a group ora 
region. 


ID.outOfBoundsEvent[+|-time_value] 


This interactive event occurs when the viewer moves the screen pointer off 
of the clip’s “in bounds” area. The event occurs even if the clip has 
finished playing and appears frozen onscreen. The target ID must be that 
of a clip, not a group or a region. 


The inBoundsEvent and outOfBoundsEvent values can occur for multiple clips 
simultaneously if clips are stacked on top of each other. The z-index value of 
the clips does not matter, and an event can still occur even if the clip is 
completely obscured by another clip. 


For More Information: For details on z-index, see “Stacking 
Regions That Overlap” on page 288. 
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Sample Values 


The following are samples of begin and end values that start or stop an element 
relative to a mouse event: 


begin="ID.activateEvent” Start the element when the clip with the given ID is 
clicked. 
begin="ID.inBoundsEvent” Start the element when the cursor moves over the 


clip with the given ID. 


end="ID.outOfBoundsEvent+1s” Stop the element one second after the cursor 
moves off the clip with the given ID. 


Examples 


The following sections provide some examples of the many uses of interactive 
timing available through activateEvent, inBoundsEvent, and outOfBoundsEvent. 


Starting a Clip when Another Clip is Clicked 


Suppose that you want to start a video when an image button is clicked. You 
first add an ID to the clip source tag of the image: 


<img src="button1.gif” id="button” dur="5s” fill="freeze” region="button_1”/> 


Next, you define the begin and end times for the video, using activateEvent and 
the image clip’s ID: 


<video src="videol.rm” region="video_region” begin="button.activateEvent” /> 


Although not always necessary, the clip that is activated (the video clip in the 
example above) typically resides in an exclusive group, a group in which only 
one element at a time can play. For more on these groups, see “Creating an 
Exclusive Group” on page 259. 


Changing a Background Color on a Mouseover 


Using SMIL’s advanced timing attributes, you can replicate rollover effects 
created in HTML pages with Javascript. In the following example, the image 
has a transparent background and displays in front of a white background. 
The <set/> tag changes the region’s background color to red when the screen 
pointer moves over the image, and then change the color back to white when 
the pointer moves off the image: 
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<img src="image.png" id="image1" region="image_region" dur="1min" ...> 
<set targetElement="image_region" attributeName="backgroundColor" to="red" 
begin="image1.inBoundsEvent" end="image1.outOfBoundsEvent"/> 
</img> 


For More Information: See Chapter 17 for information on SMIL 
animations. The section “Setting an Attribute Value” on page 
436 explains the <set/> tags. 


Changing a Clip on a Mouseover 


By animating a region’s z-index value, you can bring the region and the clip it 
contains forward on a mouseover. Suppose that you define regions that are 
the same size, but the second region has a higher z-index value that places it in 
front of the first region: 

<region id="image_region1" fit="fill" z-index="1"/> 

<region id="image_region2" fit="fill" z-index="2"/> 


With this layout, you can hide a clip in image_region1 and display a clip in 
image_region2. Using a SMIL animation tag along with advanced timing 
commands, you can move the hidden clip forward when the screen pointer 
moves over the visible clip, then hide the clip again when the screen pointer 
moves off it: 
<par> 

<img src="imagel.jpg" id="image1" region="image_region1" .../> 

<img src="image2.jpg" id="image2" region="image_region2" .../> 

<set targetElement="image_region1" attributeName="z-index" to="3" 

begin="image2.inBoundsEvent" end="image1.outOfBoundsEvent"/> 


</par> 
There are several points to note about the preceding example: 


+ The SMIL animation plays in parallel with the two image clips, and 
remains active as long as the parallel group is active. Hence, timing 
attributes for the image clips or parallel group determine how long the 
animation stays active. 


+ The <set/> tag increases the hidden region’s z-index value to place it in 
front of the displayed region on the mouseover, resetting the value when 
the screen pointer moves off the region. The begin and end times are tied 
to the clip that is in front at the time, because only the foremost clip 
registers a mouseover event. 
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- Although this sample animates a region’s z-index value, the animation 
trigger is a mouse event on a clip. Regions do not register mouse events. 
Only clips can do this. 


For More Information: See Chapter 17 for information on SMIL 
animations. The section “Stacking Regions That Overlap” on 
page 288 explains z-index attributes. 


Defining a Keyboard Event 


In addition to mouse events, you can use keyboard events to start or stop 
elements. A keyboard event can occur when a viewer presses a key, or it can 
occur when a clip gains or loses the keyboard focus. When a clip has the 
keyboard focus, it captures all subsequent keystrokes. When a viewer clicks a 
form created in Flash, for example, the Flash form receives the focus. The 
following are begin or end event values associated with keyboard activity: 
* accesskey(key)[+|-time_value] 

This interactive event occurs when the viewer presses the designated 

keyboard key. The key designation is case-sensitive. This value can be used 

along with activateEvent to provide multiple ways to start an element, 

either by mouseclick or keystroke. 


ID.focusInEvent[+|-time_value] 

This interactive event occurs when the clip with the designated ID receives 
the keyboard focus and captures subsequent keystrokes. The focus 
typically occurs when the viewer clicks the clip or tabs into it. The target 
ID must be that of a clip, not a group or a region. 


ID.focusOutEvent[+|-time_value] 

This interactive event occurs when the clip with the designated ID loses 
the keyboard focus. This typically occurs when the viewer clicks or tabs 
out of the clip. The target ID must be that of a clip, not a group ora 
region. 
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Sample Values 


The following are samples of begin and end values that start or stop an element 
relative to a keyboard event: 


begin=“accesskey(g)” Start the element when the keyboard letter “g” is 
pressed. 
end="ID.focusOutEvent+2s” Stop the element two seconds after the clip with 


the given ID loses the keyboard focus. 


Example 


«9 


In the following example, the video starts playing when the keyboard letter “g 
is pressed. It stops playing when the letter “h” is pressed: 


<video src="video1.rm” region="video_region” begin="accesskey(g)” 
end="accesskey(h)”/> 


Tips for Defining Keyboard Events 


- The access key value is case-sensitive, so the viewer cannot press g 
(lowercase “g”) to activate the event if you specify an uppercase “G” with 
accesskey(G), for example. You can specify both the lowercase and 
uppercase versions of the same key, though, to ensure that letter case does 
not matter. 


Access keys can be letters or numbers, but not function keys or command 
keys such as Alt, Esc, or F5. 


Mention the access key in a longdesc attribute in the clip source tag. See 
“Using a Long Description” on page 242 for more information. 


Your presentation should indicate which access keys the viewer can use. 
You can do this with RealText, which is described in Chapter 6. You can 
also display this information in the related info pane, as described in 
“Opening HTML Pages in the Related Info Pane” on page 373. 


If the same access key is encoded into a clip to perform some function, the 
SMIL access key overrides the encoded key’s functionality. 


You can also define access keys to open hyperlinks as described in 
“Opening a Link on a Keystroke” on page 368. To avoid conflicts, do not 
define the same key for an event and a hyperlink. 
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¢ Unlike the inBoundsEvent and outOfBoundsEvent values, which can occur for 
multiple clips simultaneously, only one clip at a time can have the 
keyboard focus at a time. Therefore, only one focusInEvent or focusOutEvent 
can occur at a time. 


Defining a Secondary Window Event 


The section “Creating Secondary Media Playback Windows” on page 277 
explains how to create a layout in which a secondary media playback window 
pops up from the main media playback pane. The following values for the 
begin and end attributes allow you to start or stop an element when a 
secondary media playback window opens or closes: 


- ID.topLayoutOpenEvent[+|-time_value] 
This event occurs when the secondary media playback window with the 
designated ID opens. The event is scheduled if the <topLayout> tag for the 
secondary media playback window uses open=“onStart”. If the tag uses 
open="whenActive”, the window event is scheduled if the element that plays 
in the window has a scheduled begin time. 


The window event is interactive, though, if the element begins because of 
another interactive event. If clicking a clip in the main media playback 
pane begins a clip that launches and plays in the secondary media 
playback window, for example, topLayoutOpenEvent is interactive. 


ID.topLayoutCloseEvent[+|-time_value] 

This event occurs when the window with the designated ID closes. The 
event is interactive if the <topLayout> tag for the secondary media playback 
window uses close="“onRequest”. If the tag uses close=“whenNotActive”, the 
window event is scheduled if the element that plays in the window has a 
scheduled end time. 


The window event is interactive, though, if the element ends because of 
another interactive event. If clicking a clip in the main media playback 
pane stops the clip or clips playing in the secondary media playback 
window, for example, topLayoutCloseEvent is interactive. 
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Sample Values 


Example 


The following are samples of begin and end values that start or stop an element 
relative to a secondary media playback window event: 


begin="ID.topLayoutOpenEvent” Start the element when the secondary media 
playback window opens. 


end="ID.topLayoutCloseEvent+2s” Stop the element two seconds after the secondary 
media playback window closes. 


The following example defines a secondary media playback window that 
opens when the first clip displays in it, and closes when all clips assigned to it 
finish playing: 


<topLayout width="180" height="120” id="popup1” open=“whenActive” 
close=“whenNotActive”> 


The following clip then starts three seconds after the window closes: 


<video src="videol.rm” region="vid" begin=”"popup1.topLayoutCloseEvent+3s” /> 


Using Media Markers 


This section to be added. 


Coordinating Clips to an External Clock 


This section to be added. 


Controlling Whether an Element Restarts 
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The restart attribute governs whether an element can play more than once. A 
clip might have multiple begin times that specify when it plays, for example, or 
start on an interactive event such as a mouse click. The restart attribute can 
prevent an element from restarting, or place restrictions on the restart. It does 
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not affect repeating cycles set with a repeatCount or repeatDur attribute, though. 
The following table summarizes the restart values. 


restart Attribute Values 


Value Function 


always Allows the element to restart at any time, even while playing. This is 
the effective value that is used if the element has no restart value, 
and no restartDefault values are specified in any groups of which 
the element is a member. 


default Sets the restart value to that specified by restartDefault. This is the 
default value that is used if no restart value is specified, but a 
containing group has a restartDefault value. 


never Prevents the element from restarting after it completes its first 
playback. 


whenNotActive | Allows the element to restart only after it has completed playing. 
The element can then restart any number of times. The restart 
occurs only after the element plays to completion, its dur or end 
time is reached, or it finishes all of its specified repeat cycles. 


In the following example, a video clip starts when a button is clicked, as 
described in “Defining a Mouse Event” on page 346. It uses the whenNotActive 
value to allow it to restart after it finishes playing. Nothing happens if the 
viewer clicks the activation button while the video plays. The viewer must wait 
for the video to stop, then click the button to restart the video: 


<video src="videol.rm” region="video_region” begin="button.activateEvent” 
restart="whenNotActive” /> 


Tip: Although the restart attribute is most commonly used 
with clips, you can also use it in group tags and other elements, 
such as SMIL animations. Keep in mind, though, that an 
element can restart only while its containing group is active. 


Setting a Default Restart Value 


You can use the restartDefault attribute in a group tag to set a restart value for 
the group and all of the elements it contains. All elements within the group 
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receive the default restart value unless they have another restart value explicitly 
set. The following table lists the possible restartDefault values. 


restartDefault Attribute Values 


Value Function 

always Allows elements within the group to restart at any time, even while 
playing. 

inherit Sets the restart value for elements in the group to the 


restartDefault value of the group’s containing group. This is the 
default value, meaning that a group without a restartDefault value 
inherits the restartDefault value from its containing group. 


never Prevents elements within the group from restarting after they 
complete their first playback. 


whenNotActive | Allows group elements to restart any number of times, but only 
after they have completed playing. Restart attempts are recognized 
only after the elements have played to completion. 


The following example shows an exclusive group of video clips in which the 
first two clips receive the restartDefault value of whenNotActive. The last clip, 
however, overrides that value with its own restart value: 
<excl restartDefault="whenNotActive”> 

<video src="videol.rm” begin="button1.activateEvent” .../> 

<video src="video2.rm” begin="button2.activateEvent” .../> 

<video src="video3.rm” begin="button3.activateEvent” restart="never” .../> 
</excl> 


Nested Group Interactions with Restart Values 


If several levels of nested groups use restart and restartDefault, it’s important to 
understand how the groups and their elements interact. Because elements 
inherit a restartDefault value by default, the interactions can be difficult to 
grasp unless you look at all levels of the nested groups. Consider the following 
abstract example: 
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<par id="master_group” restartDefault=“whenNotActive’> 
<par id="group_X” restartDefault="inherit”> 
<ref id="clip_A” .../> 
<ref id="clip_B” restart="always” .../> 


</par> 
<par id="group_Y” restart="always”> 
<ref id="clip_C” .../> 
<ref id="clip_D” .../> 
</par> 
<par id="group_Z” restartDefault="always”> 
<ref id="clip_E” .../> 
<ref id="clip_F” restart="whenNotActive” .../> 
</par> 
</par> 


The master group sets a restartDefault value of whenNotActive. The elements 
within this master group have the following restart values: 


* group_X set to whenNotActive 


group_X inherits the default value of whenNotActive from master_group, and 
passes that value to the clips it contains, one of which overrides the value: 


- clip_A set to whenNotActive 
* clip_B set to always 
* group_Y set to always 


group_Y sets its own behavior to always. However, it inherits the default 
value of whenNotActive from master_group, and passes that value to both 
clips it contains: 


- clip_C set to whenNotActive 
- clip_D set to whenNotActive 
* group_Z set to whenNotActive 


group_Z inherits the default value of whenNotActive from master_group. 
However, it changes the default value for the elements it contains to 
always. One of the clips overrides that value: 


* clip_E set to always 


- clip_F set to whenNotActive 
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HYPERLINKS 


A SMIL file can define links to other media. A video might link to a 
second video, for example, or to an HTML page that opens in a 
browsing window. You can even define areas as hot spots with links 
that vary over time. The bottom corner of a video can link to a 
different URL every ten seconds, for instance. This chapter explains 
how to create hyperlinks that open HTML pages, as well as new 


streaming media presentations. 


Understanding Hyperlinks 


SMIL provides two hyperlink tags, both found in HTML. So ifyou are familiar 
with HTML linking, you'll pick up SMIL linking quickly. The SMIL <a> tag is 
the simpler means of creating links, but the <area/> tag is more powerful. The 
<area/> tag includes all of the features of <a>, and adds additional ones, such 
as the ability to define multiple links for each clip, and to create hot spots 
(image maps) and timed links. Using the <area/> tag for all hyperlinks is 
recommended, but the <a> tag is also available for basic linking functions. 


For More Information: The two sections “Creating a Simple 
Link” on page 360, and “Using the <area/> Tag” on page 360, 
provide the basic instructions for using the two link tags. 


Links to HTML Pages 


Your SMIL file can link to HTML pages that open in a RealOne Player 
environment, or the viewer’s default Web browser. As explained in “The Three- 
Pane Environment” on page 30, RealOne Player offers three types of HTML 
windows: a related info pane, a media browser pane, and any number of 
secondary browser windows that pop up above the three-pane environment. 
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For More Information: The section “Selecting a Browsing 
Window” on page 372 explains the attributes that target the 
RealOne Player panes. 


Links to Streaming Media 


A hyperlink can also open in the RealOne Player media playback pane, 
targeting an existing SMIL region, replacing the current presentation, or 
popping up a new media playback window. Note, though, that SMIL offers 
features that you can use in place of hyperlinking. For example, you can pop 
up a new window during the course of a presentation by using SMIL layout 
tags. With advanced timing, you can start or end a clip when the viewer clicks 
another clip. Neither of these features requires hyperlinks. So before you 
define hyperlinks, be sure that you understand the possibilities offered by 
SMIL. 


For More Information: The section “Linking to Streaming 
Media” on page 377 lists the attributes and values specific to 
streaming media links. 


Linked Pop-Up Windows vs. Secondary Pop-Up Windows 


A hyperlink can pop up a new RealOne Player media playback window when 
clicked, You can also pop up a window with a <topLayout> tag as described in 
“Secondary Media Playback Windows” on page 269. Defining secondary 
media playback windows is appropriate when you want the new window to 
pop up at a predefined point in your presentation. Creating a hyperlink to a 
new RealOne Player media playback window is preferable when you want the 
new window to pop up based on viewer interaction, and the media you display 
in the window is not part of your main SMIL presentation. 


Hyperlinks vs. Exclusive Groups 


If you plan to create an interactive application, you need to consider carefully 
whether to provide interactivity through hyperlinks, exclusive groups, or both. 
Suppose that you plan to create a presentation that offers three different 
video clips that the viewer can select by clicking three buttons. You can author 
your SMIL presentation in different ways: 


+ Link the video clips to the buttons with hyperlinks. 


Using hyperlinks, you can link each button to a separate video. In this 
case, your main SMIL file does not contain <video/> tags that refer to the 
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video clips. Instead, each button uses a hyperlink to play the clip when the 
button is clicked. This method works well when you want to launch each 
video in a separate window. 


Place the video clips in an exclusive group, and use advanced timing 
commands to play each video when the viewer clicks a button. 


Within an exclusive group, you include a <video/> tag for each video clip. 
You then use advanced SMIL timing attributes to play each video clip 
when the viewer clicks one of the buttons. This method is preferable if you 
want to display all buttons and clips in a single media playback window, 
or you want to include SMIL timing and layout attributes in each <video/> 
clip source tag. 


For More Information: See “Creating an Exclusive Group” on 
page 259. Chapter 14 explains advanced timing features. 


Methods of Activating a Link 


The screen pointer turns into a hand icon when the viewer moves the pointer 
over an active link. Typically, the viewer opens the link by clicking it. SMIL lets 
you define other ways to open a link, too. You might specify a keyboard key 
that the viewer can press to open the link, for instance. Links can also open 
automatically, letting you display different Web pages as a presentation plays, 
for example. 


For More Information: See “Defining Basic Hyperlink 
Properties” on page 367 for more information about these 
features. 


General Tips for Creating Hypertext Tags 


- Hyperlink tags work only with clip source tags. You cannot make an 
entire group into a hyperlink, or turn a SMIL region into an image map. 


- Hyperlink tags cannot be nested. You can associate any number of hot 
spots or timed links defined through <area/> tags with a single clip source 
tag, however. 


- Some clips can also define hyperlinks. A RealText clip, for example, can 
define hyperlinks for portions of text. When a viewer clicks an area where 
a clip link and a SMIL link overlap, the SMIL link is used. 
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+ When turning a clip into a hypertext link, include the longdesc attribute in 
a clip source tag, using it to describe the hyperlink destination. See “Using 
a Long Description” on page 242 for more information. 


Creating a Simple Link 


The simplest type of link connects an entire source clip to another clip. As in 
HTML, you define the link with <a> and </a> tags. But whereas you enclose 
text between <a> and </a> in HTML, you enclose a clip source tag between <a> 
and </a> in SMIL: 
<a href="rtsp://helixserver.example.com/video2.rm”> 

<video src="videol.rm” region="video_region”/> 
</a> 
The preceding example links the source clip video1.rm to the target clip 
video2.rm. When the viewer clicks video1.rm as it plays, video2.rm replaces it. In 
an <a> tag, the href attribute is required. The URL begins with rtsp:// if the 
linked clip streams to RealOne Player from Helix Universal Server, or http:// if 
the file downloads from a Web server. 


For More Information: For information on link attributes, see 
“Defining Basic Hyperlink Properties” on page 367. See either 
“Linking to HTML Pages” on page 371 or “Linking to 
Streaming Media” on page 377 depending on your intended 
link target. 


Using the <area/> Tag 
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The <area/> tag differs from the <a> tag in that you place it within the clip 
source tag rather than around it. This means that you must turn unary clip 
source tags such as <video/> into binary tags such as <video>...</video>, as 
described in “Binary and Unary Tags” on page 201. The <area/> tag typically 
ends with a closing slash, but in some cases you need to use an <area>...</area> 
tag pair. The following is a basic <area/> tag that links one video clip to a 
second video clip: 
<video src="videol.rm” region="video_region”> 

<area href="rtsp://helixserver.example.com/video2.rm”/> 
</video> 
If the <area/> tag includes no spatial coordinates, the entire clip becomes a 
link, making the <area/> tag function just like the <a> tag. A clip source tag 
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can include any number of <area/> tags. When you define multiple <area/> 


links for a single clip, however, you need to do one or both of the following: 


+ Specify temporal coordinates so that each <area/> link is active at a 
different time. 


+ Define spatial coordinates in each <area/> tag to turn each link into a hot 


spot that does not overlap the other hot spots. 


Creating a Timed Link 


An <area/> tag can include temporal attributes that specify when the link is 


active, relative to the start of clip playback. If you do not include temporal 


attributes, the link stays active as long as the source clip appears onscreen. To 


add timing attributes, use the SMIL begin and end values. You cannot use dur, 


clipBegin, or clipEnd, however. 


The following example creates two temporal links for the clip videol.rm. The 


first link is active for the first 30 seconds of playback. The second link is active 


for the next 30 seconds. Because no spatial coordinates are given, the entire 


video is a link: 


<video src="videol.rm” region="video_region”> 
<area href="http://www.real.com” begin="0s” end="30s”.../> 
<area href="http://www.realnetworks.com” begin="30s” end="60s”.../> 


</video> 


Tip: An active link is one that the viewer can open, whether by 
clicking it or pressing the link’s access key. The link does not 
open automatically, however, unless you use actuate=“onLoad”. 
For more information, see “Opening a URL Automatically” on 
page 369. 


For More Information: For more on the begin and end attributes, 
see “Setting Begin and End Times” on page 314. These 
attributes use the SMIL timing values described in “Specifying 
Time Values” on page 313. See “Opening Pages on a Mouse 
Click” on page 387 for an example of hyperlinks that vary over 
time. 


Defining Hot Spots 


To create a hot spot with an <area/> tag, you use the shape attribute to define 


the hot spot’s shape, and a coords attribute to define the hot spot’s size and 
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placement. You define the shape and coords attributes in SMIL just as you do 
in HTML 4.0. You can use either pixel measurements or percentages to define 
any hot spot. The following example shows two hot spots created for a clip: 
<video src="videol.rm” region="video_region”> 

<area href="...” shape="rect” coords="20,40,80,120” .../> 

<area href="...” shape="circle” coords="70%,20%,10%” .../> 
</video> 


How you specify the coordinate values depends on what shape (rectangle, 
circle, or polygon) you want, as explained in the following sections. In all hot 
spots, the coordinates are measured from the media clip’s upper-left corner 
regardless of where you place the clip in a region. 


Creating a Rectangular Hot Spot 


Use shape=“rect” to create a rectangular hot spot. You then specify four coords 
values in pixels or percentages to set the hot spot’s size and placement, 
measured from the upper-left corner of the source clip in the following order: 


1. distance of the hot spot rectangle’s left edge from the clip’s left edge 
(left-x) 

2. distance of the hot spot rectangle’s top edge from the clip’s top edge 
(top-y) 

3. distance of the hot spot rectangle’s right edge from the clip’s left edge 
(right-x) 

4. distance of the hot spot rectangle’s bottom edge from the clip’s top edge 
(bottom-y) 


Coordinate values are separated by commas, as shown in the following 


example: 
<video src="videol.rm” region="video_region”> 

<area href="...” shape="rect” coords="20,40,80,120"/> 
</video> 


The preceding example uses pixel values to define a hot spot 60 pixels wide (80 
pixels minus 20 pixels) and 80 pixels high (120 pixels minus 40 pixels). It 
creates a hot spot like that shown in the following illustration. 
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Rectangular Hot Spot 


40 
20 


120 


shape="rect" coords="20,40,80,120" 


Tip: Think of the first pair of values as defining the x and y 
coordinates of the hot spot’s upper-left corner, and the second 
pair of values as defining the x and y coordinates of the hot 
spot’s lower-right corner. 


Defining a Circular Hot Spot 


You can use shape="circle” to create a circular hot spot. Three coords values 
then specify in pixels or percentages the circle’s center placement and radius in 
the following order: 


1. distance of the hot spot circle’s center from clip’s left edge (center-x) 
2. distance of the hot spot circle’s center from the clip’s top edge (center-y) 


3. the hot spot circle’s radius 


The coordinate values are separated by commas, as shown in the following 


example: 
<video src="videol.rm” region="video_region”> 

<area href=...” shape="circle” coords="100,120,50"/> 
</video> 


The preceding example uses pixel values to place the circular hot spot’s center 
100 pixels in from the clip’s left edge, and 120 pixels down from the clip’s top 
edge. The hot spot has a radius of 50 pixels. The following figure illustrates 
this example. 
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Circular Hot Spot 


wt 50 


shape="circle" coords="100,120,50" 


Tip: The last value, which sets the circle’s radius, should not be 
more than the smaller of the other two values. If the first two 
values are 40 and 20, for example, the third value should not be 
more than 20. Otherwise, part of the circle extends beyond the 
clip boundaries and is cut off. 


Making a Polygonal Hot Spot 


Use shape=“poly” to make a polygonal hot spot with any number of sides. You 
might create a triangle or an octagon, for example. For every n sides of the 
polygon you want to create, you must specify 2n values in the coords attribute. 
To create a triangle, for example, you need to specify six coords values. Each 
pair of coordinate values indicates the placement of a corner of the polygon in 
this order: 


1. distance of the polygon corner from the clip’s left edge (corner-x) 


2. distance of the polygon corner from the clip’s top edge (corner-y) 
The following example defines a triangular hot spot: 
<video src="videol.rm” region="video_region”> 


<area href="...” shape="poly” coords="40,150,120,30,200,150” /> 
</video> 


The following figure illustrates the preceding example. The first value pair for 
the coords attribute defines the triangle’s lower-left corner. The coords value 
pairs then proceed clockwise, defining the top corner, followed by the lower- 
right corner. 
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Polygonal Hot Spot 


150 150 


40 


shape="poly" coords="40,150,120,30,200,150" 


Tip: When defining a polygon, you can start with any corner, 
specifying the placement of additional corners by going 
around the polygon either clockwise or counter-clockwise. 


Tips for Defining Hot Spots 


When a clip is a different size than its playback region, a fill, meet, or slice 
value for the fit attribute in the <region/> tag may resize the clip. In these 
cases, a hot spot defined with percentages scales with the clip, whereas 
one defined with pixels does not. If the clip is the same size as the region, 
or the region’s fit value is hidden or scroll, the clip does not scale. For more 
information, see “Fitting Clips to Regions” on page 301. 


A viewer may resize a presentation manually by, for example, clicking and 
dragging a RealOne Player corner. In these cases, hot spots scale with clips 
whether you define the hot spots with pixels or percentages. You can 
prevent a clip from resizing, though, as explained in “Controlling Resize 
Behavior” on page 279. 


You can use whole and decimal values for percentages with the coords 
attribute. For example, the values “4%” and “4.5%” are both valid. 


You can mix pixels and percentages in the coords attribute. For example, 
the attribute coords="50,50,100%,100%” places a rectangular hot spot’s left 
and top boundaries in and down S0 pixels from the source clip’s upper- 
left corner, respectively. But the hot spot’s right and bottom boundaries 
extend to the source clip’s right and bottom edges, respectively, no matter 
the source clip’s size. 
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+ Values such as coords="30,30,10,10” for a rectangular hot spot are ignored, 
and the hot spot will not function. Here, the hot spot’s left side is defined 
as being farther to the right than its right side. As well, the top is defined 
to be below the bottom. 


A hot spot defined to extend beyond the source clip is cropped at the clip’s 
edge. For example, if a rectangular hot spot uses coords="50,50,300,300” 
but the source clip is 200 by 200 pixels, the hot spot’s effective coordinates 
are “50,50,200,200". For this reason, no percentage value can effectively be 
more than 100%. 


If multiple hot spots overlap on a clip, the link for the hot spot defined 
first in the SMIL file is used when the viewer clicks the overlapping area. 


Many programs, including shareware and freeware, can generate HTML 
image maps. You can use one of these programs to define the coordinates 
for a hot spot. Simply create an HTML image map over an image that is 
the same size as your clip, view the HTML source, and copy the image map 
coordinates into your <area/> tag. 


The following table lists sample percentage coordinates that define 
rectangular hot spots for a source clip. Each hot spot is a quarter the size 
of the source clip. 


Sample Percentage Coordinates for a Rectangular Hot Spot 


Hot Spot Rectangle Position Attributes 


upper-left quadrant shape="rect” coords="0,0,50%,50%” 
upper-right quadrant shape="rect” coords="50%,0,100%,50%” 
lower-left quadrant shape="rect” coords="0,50%,50%,100%" 
lower-right quadrant shape="rect” coords="50%,50%,100%,100%" 
center shape="rect” coords="25%,25%,75%,75%" 
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Defining Basic Hyperlink Properties 


The hyperlink attributes summarized in the following table affect link 
properties in <a> and <area/> tags whether the link opens an HTML page or a 
media presentation. 


Basic Hyperlink Attributes 


Attribute Value Function Reference 

accesskey |key_name | Defines a key stroke that opens the link. page 368 

actuate onLoad| Opens the link automatically or on request. page 369 

onRequest 

alt text Supplies alternate text. page 370 

href URL Provides the link URL. page 367 

nohref (none) Indicates no URL (<area/> tag only). page 368 

tabindex | integer Sets a tabbing order for links. page 370 
Tip: The accesskey, alt, and tabindex attributes are defined the 
same in SMIL 2.0 as they are in HTML 4.0. 

Specifying the Link URL 


As with an HTML hyperlink, the SMIL href attribute specifies the URL to 
open. This should be an HTTP URL for items opened in a browser window, 
whether those items reside on a Web server or Helix Universal Server. SMIL 
files or clips opened in RealOne Player should generally have an RTSP URL if 
they reside on Helix Universal Server. They must have an HTTP URL if they 


reside on a Web server, however. See the following sections for more 


information: 


- For information on URL formats, see “Writing Clip Source URLs” on page 
215. Although this section discusses URLs for clip source tags such as 
<video/>, the basic URL format is the same for hyperlinks. 


- To display a link target in a Web browser, follow the instructions in 
“Linking to HTML Pages” on page 371. 


- When opening a streaming media clip or SMIL file, use the additional 
attributes described in “Linking to Streaming Media” on page 377. 
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Leaving Out a URL Reference for Hot Spots 


Note: The nohref attribute is not currently functional in 
RealOne Player. 


The nohref attribute, which can be used only in <area/> tags, indicates that the 
hot spot has no URL associated with it. You can use nohref with interactive 
timing commands to start another clip when the hot spot is clicked, for 
example. The nohref attribute does not take a value. 


Opening a Link ona Keystroke 


Note: The accesskey attribute is not currently functional in 
RealOne Player. 


The accesskey attribute defines a keyboard key that the viewer can press to 
open the link. The viewer presses just the defined key, and does not need to 
press a helper key such as Alt to open the link. You can define any number of 
access keys for a link. In the following example, the viewer could press the 
keyboard letter m to open the link: 


<area href="http://www.example.com” accesskey="m” .../> 


Tips for Defining Access Keys 


- The access key value is case-sensitive, so the viewer cannot press m 
(lowercase “m”) to open the link if you specify an uppercase “M” with 
accesskey="M”, for example. You can specify both the lowercase and 
uppercase versions of the same key, though, to ensure that letter case does 
not matter. 


+ Access keys can be letters or numbers, but not function keys or command 
keys such as Alt, Esc, or F5. 


- As long as the clip associated with the link is visible, the viewer can click 
the link as well as open it with the access key. You cannot define a link 
that is accessible only through an access key. However, you can create the 
hyperlink as a very small hot spot, such as a one-pixel rectangle. 


+ When you make an entire source clip a link, mention the access key ina 
longdesc attribute in the clip source tag. See “Using a Long Description” 
on page 242 for more information. 
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- Your presentation should indicate which access keys the viewer can use. 
You can do this with RealText, which is described in Chapter 6. You can 
also display this information in the related info pane, as described in 
“Opening HTML Pages in the Related Info Pane” on page 373. 


+ If the same access key is encoded into a clip to perform some function, the 
SMIL access key overrides the encoded key’s functionality. 


+ It is best not to use the same access key when defining multiple links that 
are active at the same time. If multiple, active links use the same access 
key, the following criteria determine which link opens when the viewer 
presses the access key: 


- Links for clips not assigned to regions (such as audio clips) override 
links for clips assigned to regions. 


+ When a clip displays in front of other clips because its region has a 
higher z-index value, its links override the links associated with the 
lower clips. However, if the upper clip uses a value of 1 to 50 for 
rm:mediaOpacity, the links for lower clips will open. 


For More Information: For more on rn:mediaOpacity, see “Adding 
Transparency to All Opaque Colors” on page 223. 


+ If the z-index stacking order does not determine the link precedence, 
the link that becomes active first overrides the other links. 


- If links become active at the same time, the link listed first in the 
SMIL file overrides the other links. 


- You can also define access keys to start or stop elements as described in 
“Defining a Keyboard Event” on page 349. To avoid conflicts, do not 
define the same key for an event and a hyperlink. 


Opening a URL Automatically 


The actuate attribute has a default value of onRequest, which makes the link 
open only when the viewer clicks the link, or presses the link’s access key. If 
you set actuate=“onLoad”, however, the link opens as soon as the link tag 
becomes active in the SMIL presentation timeline, without requiring any user 
input. For example, the following link opens when the video clip begins to 
play: 
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<video src="videol.rm” region="video_region”> 
<area href="http://www.example.com” actuate="onLoad”.../> 
</video> 


As described in “Creating a Timed Link” on page 361, you can use a begin 
attribute in the <area/> tag to cause the link to become active after its 
associated clip starts to play. This lets you open a link at some point after a 


clip begins to play. 


Tip: A link that uses actuate="onLoad” is still clickable, meaning 
that the viewer can reopen it after it opens automatically. Ifyou 
want to prevent this, set a short link duration by using 
dur="1s", for example, in the <area/> tag. 


Displaying Alternate Link Text 


A hyperlink can include an alt attribute that uses short, descriptive text as its 
value. It is good practice always to include an alt attribute in hyperlinks. When 
the viewer moves the screen pointer over the link, the alt text displays in the 
status line above the RealOne Player media playback pane, indicating what the 
link will open. In the following example, the text “Visit RealNetworks” is used 
for the alt value: 


<area href="http://www.realnetworks.com” alt="Visit RealNetworks” .../> 


If the clip that includes the link also has an alt value, the link’s alt value 
displays instead of the clip’s. If the link has no alt value, its URL displays in 
place of the clip’s alt value. In short, a link always overrides the clip’s alt value. 


For More Information: The section “Including an Alternate Clip 
Description” on page 242 covers the alt attribute in clip source 
tags. See “Coded Characters” on page 237 for information on 
including special characters in alt text. 


Setting a Tab Index for Multiple Links 


When multiple links appear onscreen, the viewer can press Tab to cycle 
between the links, then press Enter to open a link. Using the tabindex attribute, 
you can specify the tabbing order. This attribute, which has a default value of 
O, takes a positive integer as a value. RealOne Player highlights the clip with 
the lowest tabindex value first. It highlights the clip with the next higher 
tabindex value each time the viewer presses Tab. The following is an example of 
two clips playing in parallel, each of which has a hyperlink: 
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<par> 
<img src="...” region="ad_region”...> 
<area href="...” tabindex="2” .../> 
</img> 
<video src="...” region="video_region”... > 
<area href="...” tabindex="1" .../> 
</video> 
</par> 


In the preceding example, the link for the video clip has the lower tabindex 
value, so RealOne Player highlights it first when the viewer presses Tab. 
RealOne Player highlights the image clip next when the viewer presses Tab 


again. 
Tip: If two or more <area/> tags have the same tabindex value, 
the tabbing order follows the order in which the clip source 
tags appear in the SMIL file. This also occurs if you leave 
tabindex out of all <area/> tags. 
Linking to HTML Pages 


The attributes summarized in the following table allow you to open HTML 
pages from your SMIL presentation. You can use these attributes to open a 
Web page while a presentation plays, for example. Web page links open by 
default in a RealOne Player browsing pane, though you can also open them in 
the viewer’s default browser. 


Attributes for Opening a Link in a Web Browser 


Attribute Value Default Function Reference 
rn:contextWindow |auto|openAtStart | auto Sets when related info | page 374 
pane opens. 
external false|true false Opens link in a page 372 
browser when true. 
height pixels media | Sets related info pane | page 374 
height | height in <param> tag. 
rn:sendTo _osdefaultbrowser| | (none) Specifies window that | page 372 
_rpbrowser| opens the HTML page 373 
_rpcontextwin page. 
sourceLevel percentage 100% | Sets audio level. page 382 
sourcePlaystate pause|play|stop pause | Changes source state. | page 376 


(Table Page 1 of 2) 
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Attributes for Opening a Link in a Web Browser (continued) 
Attribute Value Default Function Reference 


target name current | Targets window or page 375 
window | frame. 


width pixels 330 Sets related info pane | page 374 
width in <param> tag. 
(Table Page 2 of 2) 


Tip: You can also open an HTML URL through a Ram file. 
This is useful for presentations that consist of a single clip, and 
do not require the advanced features that SMIL provides. For 
instructions on this, see “Opening a URL in an HTML Pane” 
on page S11. 


Selecting a Browsing Window 


For a SMIL hyperlink to open in a Web browser, the external attribute must be 
set to true. (The external attribute’s default value is false, however, which opens 
the link in the RealOne Player media playback pane.) The link must also use 
an HTTP URL that the browser can request. Minimally, a SMIL link for 
content played in a Web browser looks like the following example: 


<area href="http://www.example.com” external="true”/> 
Using external="true” is the only requirement for opening an HTML page ina 
Web browser. As described in “Links to HTML Pages” on page 357, however, 


RealOne Player offers several browsing panes. The following table lists the 
attributes required to open an HTML URL in one of these panes. 


Attributes for HTML Page Hyperlinks 


Attributes Target Reference 


external="true” A secondary browsing window that page 372 
does not attach to the media playback 
and related info panes. 


external="true” The media browser pane, which can page 373 
rm:sendTo="_rpbrowser” attach to, or detach from, the media 
and related info panes. 


external="true” The viewer’s default Web browser. page 373 
rn:sendTo=“_osdefaultbrowser” 

external="true” The related info pane, which appears to | page 373 
r:sendTo="_rpcontextwin” the right of the media playback pane. 
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Note the following important points about using the rn:sendTo attribute: 


+ The rn:sendTo attribute works only in SMIL <area/> tags. It does not 
function with <a> tags. 


- Using the rn:sendTo attribute requires that you declare the following 
namespace in the <smil> tag: 


xmlns:rn=“http://features.real.com/2001/SMIL20/Extensions” 


For More Information: For background on customized 
attributes and namespaces, see “Using Customized SMIL 
Attributes” on page 203. 


Targeting the Media Browser Pane 


RealOne Player’s media browser pane can attach to, or detach from, the media 
playback and related info panes. This is the recommended pane for displaying 
Web pages along with your presentation. To target this pane, declare the 
RealNetworks extensions namespace in your <smil> tag as described above, 
and use a hyperlink that looks like the following: 


<area href="http://www.example.com” external="true” rn:sendTo="_rpbrowser” .../> 


Tip: To target this pane from an HTML page displaying in the 
related info pane or a secondary browsing window within the 
RealOne Player environment, use <a href="URL” 
target="_rpbrowser’>. 


Using the Viewer’s Default Browser 


Web page links open in a RealOne Player media browser pane by default. 
Although this is preferred means for displaying these pages, you can also open 
these links in the viewer’s default Web browser. To do this, declare the 
RealNetworks extensions namespace in your <smil> tag as described above, 
and create a link that looks like the following: 


<area href="http://www.example.com” external="true” 


rn:sendTo="_osdefaultbrowser” .../> 


Opening HTML Pages in the Related Info Pane 


Appearing to the right of the media playback pane, the related info pane can 
display HTML pages that supplement your SMIL presentation. It might 
display title and copyright information about clips as they play, for example. 
Using the SMIL timing features described in Chapter 13 and Chapter 14, as 
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well as the hyperlinking features described in this chapter, you can open a URL 
in the related info pane at any time during the presentation. 


To open an HTML page in the related info pane, declare the extensions 
namespace (xmlns:rn=“http://features.real.com/2001/SMIL20/Extensions”) in 


7 


your <smil> tag, and add rn:sendTo="_rpcontextwin” to the <area/> link tag: 


<area href="http://www.example.com/context.html” external="true” 


rn:sendTo="_rpcontextwin” sourcePlaystate=" play” /> 


Setting the Related Info Pane Size 


Through <rn:param/> tags, you can extend an <area/> tag link to include sizing 
information for the RealOne Player related info pane. This requires that you 
turn your <area/> tag into a binary tag as described in “Binary and Unary 
Tags” on page 201. To specify the related info pane width and height in pixels, 
you then add <param/> tags to the link, as shown in the following example: 
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<area href="...” external="true” rn:sendTo=" 
<rn:param name="width” value="320"/> 
<rn:param name="height” value="240"/> 
</area> 


_rpcontextwin” ...> 


Making Room for the Related Info Pane 


When the media browser pane is attached, a SMIL presentation that plays 
without an HTML page for the related info pane appears centered above the 
media browser pane. If an HTML page later opens in the related info pane, the 
SMIL presentation jumps to the left. To prevent this effect, which can be 
jarring for the viewer, include rn:contextWindow=“openAtStart” in the <root- 
layout/> tag (not the <area/> tag): 


<root-layout width="320”" height="240” rn:contextWindow="openAtStart" /> 


When you use this attribute, the SMIL presentation appears at the left side of 
the top two panes. Any HTML pages then sent to the related info pane appear 
at the right side. To prevent height resizing when an HTML page appears, 
specify the same height for the related info pane that you use in the <root- 
layout/> area. The rn:contextWindow attribute has no visible effect when the 
media browser pane is detached. 


Tips for Using the Related Info Pane 


+ See “The Related Info Pane” on page 34 for basic information about the 
size of the related info pane in relation to the other RealOne Player panes. 
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+ For best results, keep the related info pane approximately the same size as 
the media playback pane (specified with the <root-layout/> tag’s height and 
width attributes). Be careful that the combined widths of the media 
playback pane and related info pane do not make the presentation too 
large to display on small computer screens. 


- The media playback pane and the related info pane appear side-by-side 
with no divider. If the panes are the same height, you can create a uniform 
background by setting the same background color in each pane. For the 
media playback pane, you set this color with the backgroundColor attribute 
of your SMIL presentation’s <root-layout/> tag, as described in “Adding 
Background Colors” on page 290. 


- To keep the presentation playing as links open in the related info pane, 
use sourcePlaystate="play” and actuate="onLoad” in the <area/> tag in your 
SMIL file. 


- A standard hypertext link in an HTML page within a browsing window 
cannot open a URL in the related info pane because the related info pane 
requires sizing information. 


- The related info pane is designed for small HTML pages that supplement 
a media presentation. To display large Web pages, open URLs in the media 
browser pane. See “Selecting a Browsing Window” on page 372. 


Targeting a Frame or Named Window 


Note: HTML frame and window targeting is not currently 
functional in RealOne Player. 


When you use SMIL to open an HTML page, the SMIL target attribute works 
much the same as the HTML target attribute. When a hyperlink targets a 
RealOne Player secondary browsing window (using just external="true”) or the 
default browser (using rn:sendTo=" 
do one of the following: 


_osdefaultbrowser”), the target attribute can 


* open a new, named browsing window 
+ target an existing, named window 
+ select a named frame within an existing window 


When a link specifies the media browser pane (with rn:sendTo="_rpbrowser”) or 


the related info pane (using rn:sendTo="_rpcontextwin”), the target attribute can 
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select an existing frame. The following example shows how to open a link in 
the frame named rightpane within the media browser pane: 


<area href="http://www.example.com” external="true” 


7 


rm:sendTo="_rpbrowser” target="rightpane”.../> 


Tip: The HTML values _new and _top are not supported in the 
RealOne Player environment. Use actual window names 
instead. 


Controlling the Media Playback State 


By default, the SMIL presentation pauses while an HTML page link opens. 
The viewer can resume the presentation by clicking the RealOne Player Play 
button. RealOne Player typically needs to rebuffer the presentation briefly 
before continuing playback. You can also make RealOne Player stop the 
presentation completely, or continue playing when the link opens, with a stop 
or play value, respectively, for the sourcePlaystate attribute: 


<area href="http://www.example.com” external="true” sourcePlaystate="play”.../> 


Tips for Opening HTML Page Links 


+ RealOne Player passes the entire URL to the browser, which requests the 
resource. You can therefore include in the SMIL href attribute any 
additional parameters you want the browser to receive. A common use of 
this is linking to an anchor in an HTML page: 


<area href="http://www.example.com/story.html#part2” external="true”.../> 


If the RealOne Player media playback pane is operating in full-screen 
mode, it resumes normal-size operation when a link opens in a browsing 
window. For more on full-screen mode, see “Controlling How a 
Presentation Initially Displays” on page 514. 


If you use sourcePlaystate="play” to keep the SMIL presentation playing 
while the viewer’s default Web browser opens the link, you cannot prevent 
the browser from obscuring RealOne Player. Whether RealOne Player 
remains in front of other applications as it plays is entirely under the 
viewer’s control. 


When targeting modem users and using sourcePlaystate="play”, leave a few 
Kbps of bandwidth available to download HTML pages, depending on the 
size of the HTML pages that will display. To minimize bandwidth required 


CHAPTER 15: Hyperlinks 


by the browser, link to Web pages that do not contain large graphics. The 
table “Maximum Streaming Rates” on page 47 lists bandwidth targets. 


+ See “Adjusting Audio Volumes in Linked Presentations” on page 382 for 
information on using the sourceLevel attribute to change the RealOne 
Player volume when the Web page opens. 


Linking to Streaming Media 


When you link to another streaming media presentation, whether a SMIL file 
or a single clip, you can open the link URL in the existing RealOne Player 
media playback pane, or pop up a new media playback window. The following 
table summarizes the attributes that you use to link to streaming media. 


Attributes for Streaming Media Hyperlinks 


Attribute Value Default Function Reference 

href="command: | (name, (none) Opens media from Flash, | page 383 

openwindow()” | URL) RealPix, or RealText. 

destinationLevel | percentage | 100% Sets audio level of target. | page 382 

destination pause|play | play Sets play state of target. page 378 

Playstate 

show new|replace | replace Opens link in a new or the | page 378 
current window. 

sourceLevel percentage | 100% Sets audio level of source. | page 382 

sourcePlaystate | pause|play| | pause|play | Sets play state of source page 378 

stop depending on show. 

target ID (none) Links to a specific window | page 379 

or region. 


Replacing the Source Presentation 


A link that does not include the external="true” attribute (which opens the link 
in a Web browser) replaces the current presentation in the RealOne Player 
media playback pane. The source presentation is only paused, however, so the 
viewer can return to it by clicking RealOne Player's Play>Previous Clip 
command. Hence, an RTSP link like the following: 


<area href="rtsp://helixserver.example.com/video2.rm”/> 
is equivalent to the following link, in which the show, destinationPlaystate, and 


sourcePlaystate attributes are explicitly set to their default values: 
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<area href="rtsp://helixserver.example.com/video2.rm” show="replace” 
destinationPlaystate="play” sourcePlaystate=”"pause” /> 


Note: Currently, the source clip always stops, rather than 
pauses, when the destination clip replaces it. 


In some cases, you may want to set destinationPlaystate="pause” to keep the 
new presentation from playing until the viewer clicks the RealOne Player Play 
button. It’s not necessary ever to include the sourcePlaystate attribute when 
replacing a presentation in RealOne Player. Its value of pause is always used 
with show=“replace”, so specifying play or stop for sourcePlaystate has no effect. 


The following table summarizes the possible hyperlink attribute values for 
replacing a presentation in the existing RealOne Player pane. The first option 
listed in the table is the default. 


Hyperlink Attributes for Replacing a Presentation in RealOne Player 


Source Destination Attributes 

pause show="replace” sourcePlaystate="pause” 
destinationPlaystate="play” 

pause | pause show="replace” sourcePlaystate=”"pause” 


destinationPlaystate=”"pause” 


stop play or pause | Not allowed. The source state is always pause. 


Opening a New Media Playback Window with SMIL 


You can use either the show or the target attribute to open a new media 
playback window. The basic means for doing this is to set show="new” in the 
link tag. You can open any number of new windows this way. Using 
show="new” does not create a named window that you can target with another 
hyperlink, however: 


<area href="rtsp://helixserver.example.com/video2.rm” show=“new”.../> 
By default, the current window containing the link and the new window with 


the target media are both set to play. Therefore, the preceding example is 
equivalent to the following example: 


<area href="rtsp://helixserver.example.com/video2.rm” show="new” 
sourcePlaystate="play” destinationPlaystate="play”.../> 


Depending on how you want linking to operate, you can change the setting for 
sourcePlaystate to pause or stop. You can also set destinationPlaystate to pause. A 
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common scenario is to pause the source presentation when the viewer opens 
the new window. The viewer can restart the source presentation by clicking the 
RealOne Player Play button. The following example illustrates this markup: 


<area href="rtsp://helixserver.example.com/video2.rm” show="new” 
sourcePlaystate="pause” destinationPlaystate=”" play” /> 


Targeting a Specific Window or Region 


Note: Targeting a named media window or region is not 
currently functional in RealOne Player. 


Whereas show="new” opens a link in a new, unnamed media playback window, 
target="name” creates a named window that you can select through subsequent 
hyperlinks. It also lets you open linked media in a specific SMIL region of an 
existing window, rather than in a new window. The show="new” attribute does 
not include these two capabilities. 


The target attribute takes a user-defined name as its value. As with show=“new”, 
you can set sourcePlaystate to play, pause, or stop. You can also set 
destinationPlaystate to play or pause. The following example defines a link that 
opens in a SMIL region or a new window named play3: 


<area href="rtsp://helixserver.example.com/video2.rm” target=“play3” 
sourcePlaystate="pause” destinationPlaystate="play”.../> 


When RealOne Player opens the link in preceding example, it displays the 
linked media in the following way: 


1. RealOne Player displays the linked media in the existing SMIL region 
named play3. That is, it looks for a SMIL region in any open window that 
has the play3 ID: 


<region id="play3” .../> 


2. Ifno SMIL region named play3 exists, RealOne Player displays the linked 
media in the window named play3. That is, it looks for a window created 
through a previous hyperlink that used a target="play3” attribute. 


3. If no window named play3 exists, RealOne Player creates a new window 
with the play3 name, displaying the linked media in that window. 
Tips for Opening Streaming Media in New Windows 
- If you use both target and show in a link, the show attribute is ignored. 


- You can use target exclusively to define your streaming media hyperlinks: 
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+ To replace the current presentation, include neither target nor show. 


Replacing the presentation is the default action, so you do not need to 


include these attributes. 


- Use target="name” to open a link in a SMIL region, or in a new or 


existing window. 


+ The following table summarizes the attribute values for opening 


streaming media in a new RealOne Player window, using either 


show="new” or target="name”. 


Attributes for Opening Streaming Media in a New Window 


Source Destination Attributes 
play play show="new” |target="name” 

sourcePlaystate="play” destinationPlaystate="play” 
play pause show="new” |target="name” 

sourcePlaystate="play” destinationPlaystate=" pause” 
pause | play show="new” |target="name” 

sourcePlaystate="pause” destinationPlaystate=" play” 
pause | pause show="new” |target="name” 

sourcePlaystate="pause” destinationPlaystate="pause” 
stop play show="new” |target="name” 

sourcePlaystate="stop” destinationPlaystate="play” 
stop pause show="new” |target="name” 


sourcePlaystate="stop” destinationPlaystate="pause” 


+ To avoid possible conflicts, use unique names for all SMIL regions and all 


windows that you open with target="name”. 


- Use short, single-word names with target="name”. 


- Do not use target="_new”. 


” 


+ When you open linked media in a new or existing window, the window 


resizes to the media’s defined size. 


+ When you open linked media in an existing SMIL region, the window does 


not resize, and the region’s fit attribute determines how the linked media 


appears if the region and media are different sizes. See “Fitting Clips to 


Regions” on page 301 for more on fit. 
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Linking to a SMIL Fragment 


Note: SMIL fragment linking is not currently functional in 
RealOne Player. 


A SMIL file hyperlink can target a specific place in another SMIL file, or 
another part of itself. To create a link of this type, you include the appropriate 
SMIL ID in the href attribute after the URL and a pound sign (#), just as if 
linking to an HTML fragment: 


<area href="rtsp://helixserver.example.com/movie2.smil#text_and_video” .../> 


The preceding link would open the designated SMIL file, and start playback at 
the clip or group that included the text_and_video ID: 
<par id="text_and_video”> 
<video src="video2.rm” region="newsregion” /> 
<textstream src="text.rt” region="textregion”/> 
</par> 


Note that the target SMIL file defines two regions, newsregion and textregion. 
When RealOne Player receives the new SMIL file, it creates those regions as 
specified in the new SMIL file’s header. 


Linking to a Clip with a Timeline Offset 


You can use the <area> tag’s time coordinates to create a timeline offset in a 
linked clip. Suppose that you want to link a video to another video at 30 
seconds into the second video’s timeline. In the source SMIL file, you define a 
link from the first video to a SMIL file that contains the second video. In the 
second SMIL file, the video’s <area> tag defines the timeline offset using SMIL 
timing parameters. 


Here is a sample of the link in the first SMIL file: 
<video src="videol.rm” region="video_region”> 
<area href="rtsp://helixserver.example.com/newmedia.smil#vid2”/> 
</video> 
The following is the linked video clip in the second SMIL file, newmedia.smil: 


<video src="video2.rm” region="newsregion”> 
<area id="vid2" begin="30s"/> 
</video> 


For More Information: “Specifying Time Values” on page 313 
describes the SMIL timing values. 
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Tips for Linking to SMIL Fragments 
+ To link to a fragment within the same SMIL file, use only href="#ID". 


+ You can link to any clip, <par>, <seq>, <excl>, or <switch> group by defining 
an id attribute for the clip or group. Do not link to an element in a SMIL 
file header, however, or to an element within a <switch> group. 


+ You cannot link to a clip in a <par> group and exclude the other clips in 
that group. All clips in the group will play in their designated regions. 


+ If additional clips follow the target clip in the SMIL file, those clips play as 
well. If you want to link to a single clip, but the SMIL file that contains 
the clip includes other clips as well, link to the desired clip directly. Or 
create a new SMIL file that lists only the single target clip. 


Adjusting Audio Volumes in Linked Presentations 


Note: Audio level adjustments are not currently functional in 
RealOne Player. 


Two attributes in a hyperlink tag, sourceLevel and destinationLevel, can change 
the volume of the source clip and the destination clip when a link opens. If the 
source clip does not stop or pause when the link opens, for example, you can 
use sourceLevel to turn down the source clip’s volume and boost the 
destination clip’s volume: 


<area href="...” sourceLevel="35%”" destinationLevel="125%".../> 


The audio level attributes always use a percentage value. The default value of 
100% plays the audio at its recorded volume. A value of 50%, for example, plays 
the audio at half its normal volume, whereas a value of 200% plays the audio 

at twice its normal volume. 


Note that the sourceLevel and destinationLevel attributes control only the 
relative volume of the audio stream sent to the speakers. They do not change 
the general sound level setting on the viewer’s computer, which remains 
entirely under the viewer’s control. All sound level adjustments are subject to 
limitations in the computer hardware. 


Tip: When displaying a Web page, as described in “Linking to 
HTML Pages” on page 371, you can use sourceLevel to turn 
down or boost RealOne Player’s volume as appropriate. The 
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destinationLevel attribute will not affect any audio elements, 
such as an embedded WAV file played by the browser, though. 


Opening a Media Playback Window with a Clip Link 


A RealText, RealPix, or a Flash clip, playing alone or as part of a SMIL 
presentation, can define a hyperlink that opens another clip in a new media 
playback window, and stops the original presentation, on a click. This type of 
link uses a proprietary parameter, command:openwindow(name,URL), as the value 
of the href attribute. This is not a SMIL feature, and you write this parameter 
directly into the RealText or RealPix markup, or encode it in the Flash Player 
file with the Get URL command. 


The hypertext reference for this type of link has the following structure: 
href=“command:openwindow(name, URL, [zoomlevel=double|full|normal])” 

The command:openwindow parameter requires two arguments, name and URL. 
The zoomlevel argument is optional. You can separate arguments with a 
comma, but this is not required. A space may precede or follow a comma. If an 


argument contains characters such as commas or parentheses, enclose it in 
single quotation marks. 


Window Names 


The required name argument, which supplies a predefined or user-defined 
name for the new media playback window, is the first parameter listed for 
command:openwindow. The following table describes the parameter values. 


name Parameter 


Value Action 


_new or | Opens anew media playback window each time the viewer clicks the link. 


_blank Each subsequent link named _new or _blank opens a new window as well. 
_self or | Opens the URL in the current media playback window. 
_current 
name Creates a new media playback window with the user-defined name. A 
subsequent openwindow command using the same name opens the given 
URL in the same window. 
Target URL 


Following the name argument, the required URL argument gives the fully 
qualified URL to the clip or SMIL presentation to play in the new window. 
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You must include the protocol (rtsp://, http://, chttp://, or file://) in the URL. 
Relative URLs do not work. 


For testing, or if developing a presentation that plays back locally for all 
viewers, you can use absolute, local URLs in the following format, which 
includes three forward slashes in file:///, and uses forward slashes in path 


names as well: 


file:///C:/My Documents/videos/video1.rm 


Zoom Level 


The optional zoomlevel=double|full|normal argument sets the new media 
playback window to open in double-size or full-screen mode respectively. The 
normal value is the default. If the operating system does not support full- 
screen mode, normal mode is used instead. 


For More Information: You can also open the initial presentation 
in double or full-screen mode by using a Ram file. For details 
on doing this, as well as guidelines for using double and full- 
screen modes, see “Controlling How a Presentation Initially 
Displays” on page 514. 


Note: Earlier versions of RealPlayer support additional 
parameters, such as autosize and ontopwhileplaying, that 
RealOne Player ignores. RealOne Player is therefore backwards- 
compatible with presentations developed for earlier versions of 
RealPlayer. These additional parameters are obsolete, however. 


Examples 


The following examples show how to target various windows with the 
command:openwindow hyperlink syntax inRealText and Flash clips. These 
examples link to single RealVideo clips, but you can link to any streaming clip 
or SMIL presentation. 


Targeting the Same Window with Multiple Links 
The following RealText link opens a URL in a new media playback window 
named feature: 


<a href="command:openwindow(feature, 
rtsp://helixserver.example.com/comedy.rm)”>Comedy Hour</a> 


The syntax in RealPix is the following: 


url="command:openwindow(feature, rtsp://helixserver.example.com/comedy.rm)” 
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In Flash, the Get URL command looks like this: 

command:openwindow(feature, rtsp://helixserver.example.com/comedy.rm) 
When first clicked, this link creates a media playback window named feature. 
If another link also targets the feature window, clicking that link starts the 


new URL in the feature window. Clicking the link in the following example 
starts an animal program in the window running the comedy program: 


<a href="command:openwindow(feature, 
rtsp://helixserver.example.com/animals.rm)”>Sharks!</a> 


The RealPix markup is this: 

url="command:openwindow(feature, rtsp://helixserver.example.com/animals.rm)” 
The Flash Get URL version looks like this: 

command:openwindow(feature, rtsp://helixserver.example.com/animals.rm) 
Opening Separate Windows 

Each link opens a separate window if the window names are different, or you 


use the predefined name _new or _blank. The following RealText links open 
separate windows: 


<a href="command:openwindow(_new, 
rtsp://helixserver.example.com/comedy.rm)”>Comedy Hour</a> 


<a href="command:openwindow(_blank, 
rtsp://helixserver.example.com/animals.rm)”>Sharks!</a> 


The following are the corresponding RealPix links: 
url="command:openwindow(_new, rtsp://helixserver.example.com/comedy.rm)” 
url="command:openwindow(_blank, rtsp://helixserver.example.com/animals.rm)” 
In Flash, the Get URL commands look like these: 
command:openwindow(_new, rtsp://helixserver.example.com/comedy.rm) 
command:openwindow(_blank, rtsp://helixserver.example.com/animals.rm) 
Launching Clips in the Current Window 


Use either _current or _self to open the URL in the current window. The 
following example is for RealText: 


<a href="command:openwindow(_self, 
rtsp://helixserver.example.com/comedy.rm)”>Comedy Hour</a> 


The next RealText link plays the clip at double its encoded size: 
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<a href="command:openwindow(_current, 
rtsp://helixserver.example.com/animals.rm, zoomlevel=double)”>Sharks!</a> 


The following are the same commands given through RealPix: 
url="command:openwindow(_self, rtsp://helixserver.example.com/comedy.rm)” 
url="command:openwindow(_current, rtsp://helixserver.example.com/animals.rm, 
zoomlevel=double)” 

The following are the same commands issued through Get URL in Flash: 
command:openwindow(_self, rtsp://helixserver.example.com/comedy.rm) 


command:openwindow(_current, rtsp://helixserver.example.com/animals.rm, 
zoomlevel=double) 


Tips for Opening Media Windows with RealText, ReaPix, or Flash 


* Unlike HTML, RealNetworks markup tags are case-sensitive. Be sure to 
use lowercase for command:openwindow and its parameters. 


+ When the viewer clicks a command:openwindow link, the new clip 
automatically plays, and the presentation that contains the link stops. 
You cannot change this playback state to pause the original presentation, 
for example. 


+ RealText, RealPix, and Flash clips can also open Web page hyperlinks in a 
browser window. For basic information on hypertext links in RealText, see 
“Creating Links and Issuing Commands” on page 138. For RealPix, see 
“Adding a Presentation URL” on page 163 


+ Because command:openwindow is not a SMIL command, it does not offer all 
the SMIL linking features, such as activating automatically or ona 
keystroke. 


- If the area for a SMIL hyperlink overlaps that of a command:openwindow 
link, the SMIL link is used. 


+ The command:openwindow syntax is backwards-compatible with RealPlayer 
7 and RealPlayer 8, but not earlier RealPlayers, including RealPlayer G2. 


Hyperlink Examples 


The following examples show different applications of hyperlinking. To see 
more examples, get the zipped HTML version of this guide as described in 
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“How to Download This Guide to Your Computer” on page 12, and view the 
Sample Files page. 


Opening Web Pages During a Presentation 


The following markup uses a series of <area/> tags with different begin times 
to open four Web pages at different points as an audio clip plays. The 
actuate="onLoad” attribute causes each link to open its Web page as soon as the 
link becomes active. Because the links do not use rn:sendTo="_rpbrowser", the 
pages open in secondary browsing windows. The sourcePlaystate="play" 
attribute keeps the clip playing as each page opens: 


<audio src="audiol.rm"> 
<area href="http://www.example.com/page1.htm" begin="30s" external="true" 
actuate="onLoad" sourcePlaystate="play"/> 
<area href="http://www.example.com/page2.htm" begin="1min" external="true" 
actuate="onLoad" sourcePlaystate="play"/> 
<area href="http://www.example.com/page3.htm" begin="2min" external="true" 
actuate="onLoad" sourcePlaystate="play"/> 
<area href="http://www.example.com/page4.htm" begin="3min" external="true" 
actuate="onLoad" sourcePlaystate="play"/> 
</audio> 


Tip: Opening a Web page requires bandwidth. If your 
streaming media uses all of the viewer’s available bandwidth, 
opening a Web page may cause the presentation to stall. When 
opening Web pages during a presentation, be sure that your 
streaming media uses less bandwidth than the maximum 
listed in the table “Maximum Streaming Rates” on page 47. 


Opening Pages on a Mouse Click 


A link to an HTML page does not have to open automatically. If you leave out 
the actuate="onLoad” attribute, the link opens only when the viewer clicks the 
clip. In the following example, the video clip defines four timed hyperlinks. 
The begin and dur attributes make each link active for one minute at a 
different point in the presentation. Viewers therefore display different pages 
depending on when they click the video clip: 
<video src="rtsp://helixserver.example.com/videol.rm"> 

<area href="http://www.example.com/pagel.htm" begin="0s" dur="1min" 


external="true" rn:sendTo="_rpbrowser" sourcePlaystate="pause" 
alt="Go to Page 1"/> 
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<area href="http://www.example.com/page2.htm" begin="1min" dur="1min" 
external="true" rn:sendTo="_rpbrowser" sourcePlaystate="pause" 
alt="Go to Page 2"/> 

<area href="http://www.example.com/page3.htm" begin="2min" dur="1min" 
external="true" rn:sendTo="_rpbrowser" sourcePlaystate="pause" 
alt="Go to Page 3"/> 

<area href="http://www.example.com/page4.htm" begin="3min" 
external="true" rn:sendTo="_rpbrowser" sourcePlaystate="pause" 
alt="Go to Page 4"/> 

</video> 
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MASTERING ADVANCED FEATURES 


With the basics mastered, you’re ready to learn SMIL’s power 
features. Chapter 16 explains how to create special effects when 
a clip starts or stops playing. Read Chapter 17 to learn how to 
transform clips as they play. Chapter 18 explains how to stream 
different clips based on viewer criteria, such as language 
preference. Prefetching, which Chapter 19 describes, lets you 
download clip data before a clip plays. 
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TRANSITION EFFECTS 


You can enhance your presentation’s appeal by adding visual effects 
that occur when any type of visual clip starts or stops. With more 
than a hundred transition effects available, your streaming 
presentation can include special effects found in professional video 
production. You can also use transition effects to create a streaming 
slideshow from still images. 


Understanding Transition Effects 


A transition occurs every time a clip starts or stops playing. If you do not use a 
transition effect, the clip simply appears when it starts playing and, depending 
on its fill attribute, disappears when it stops playing. Using transition effects 
makes these transitions more visually compelling. Instead of just appearing 
onscreen, the clip might slowly fade in from a solid color. Or, a five-point star 
might expand from the center of a region to reveal the clip. Instead of just 
disappearing when it stops playing, a clip might crossfade into the clip that 
plays next. 


Examples of Transition Effects 
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Timelines and Transition Effects 


By default, each transition lasts one second, but you can make a transition last 
any length of time. Using transition effects does not affect a presentation’s 
timeline. For example, a two-second transition applied to the end of a clip 
occurs during the last two seconds that the clip plays. If it is applied to the 
beginning of the clip, it occurs during the first two seconds of playback. 


For More Information: For instructions on doing this, see 
“Setting a Transition Effect’s Duration” on page 407. 


Layouts and Transition Effects 


You can use a transition effect with any visual clip regardless of the layout 
you’ve defined, or whether another clip precedes or follows the clip that uses 
the effect. When a clip starts, the area it covers is treated as its background, 
whether that area is a region color, a clip in another region, or a clip in the 
same region. A transition effect simply introduces the clip over, or removes the 
clip from, its background. So when you use transitions with a sequence of 
clips, the clips do not have to be the same size. 


Animations and Transition Effects 


Transition effects are distinct from the SMIL animations described in Chapter 
17. A transition effect is a special effect that occurs when a clip starts or stops 
playing. An animation, on the other hand, is a special effect that occurs while 
a clip plays. You can use both transition effects and animations in the same 
presentation. You can even apply them to the same clip. But you define them 
separately. 


Audio and Transition Effects 


A transition effect does not change a clip’s audio level. If you slowly fade into a 
video, for example, the audio plays normally throughout the fade. You can 
change a clip’s audio level, however, by animating the clip region’s soundLevel 
attribute. See “Controlling Audio Volume in a Region” on page 292 for 
information about soundLevel. Chapter 17 describes SMIL animations. 
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Multiple Clips with Transition Effects 


Transition effects are applied to individual clips. Two clips playing in separate 
regions might end at the same time and use the same transition effect, such as 
a wipe transition that travels from left to right. In this case, two separate wipe 
transitions occur, one for each clip. Each transition effect is confined to the 
region in which the clip plays. You cannot make a single transition effect apply 
to both clips. For example, you cannot make the left-to-right wipe effect travel 
across the entire root-layout area, ushering in a new clip to each region as it 
passes over the region. 


Summary of Transition Effects Tags 


The following SMIL sample illustrates the functions and relationships of the 
tags used to create transition effects. The remainder of this chapter describes 
how to use these tags and their attributes to define and apply transition 
effects: 


<smil xmLns=“http://www.w3.org/2001/SMIL20/Language”> 
<head> 
<transition id="ID1” ...defines a transition type and duration.../> 
<transition id="ID2” ...defines a transition type and duration.../> 


</head> 
<body> 
<seq> 
<ref src="...” transIn="ID1" ...assigns a transition for the clip beginning.../> 
<ref src="...” transOut="ID2” ...assigns a transition for the clip end.../> 


</seq> 
</body> 
</smil> 


Defining Transition Types 


The SMIL file header section defines the transition effects your presentation 
uses. The following example defines three transition effects after the layout: 
<head> 
<layout> 
...layout defined here... 
</layout> 
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<transition id="fade1” type="fade” subtype="crossfade”/> 

<transition id="wipe1” type="pushWipe” subtype="fromTop” /> 

<transition id="rad1” type="radialWipe” subtype="counterTopBottom” /> 
</head> 


Each transition is defined by a separate <transition/> tag that typically has at 
least three attributes, which are described in the following table. 


Basic Transition Effects Attributes 
Attribute Function 


id Sets a unique ID used to assign the transition to clips. For rules about 
creating IDs, see “SMIL Tag ID Values” on page 202. 


type Identifies a group of transition effects. This attribute is required. 


subtype | Determines which member of the transition type group is used. 


The following sections describe the various types and subtypes for transition 
effects. For convenience, the transition effects are grouped in families that 
share broad similarities, such as edge wipes and iris wipes. In defining a 
transition, you specify only the type and subtype, however. 


Note: Most transitions listed in the following sections have an 
SMPTE (Society of Motion Picture and Television Engineers) 
code. This code is provided for persons who want to find the 
SMIL transition effect that corresponds to a specific SMPTE 
transition. SMPTE codes are not used when defining SMIL 
transition effects, though. 


Tip: To display samples of transition effects in RealOne Player, 
get the zipped HTML version of this guide as described in 
“How to Download This Guide to Your Computer” on page 12. 


Edge Wipe Transition Effects 


In the edge wipe family, an “edge” moves over the first clip, revealing the 
second clip. As an analogy, imagine a car covered with snow. As the windshield 
wiper moves, its edge reveals the underlying windshield. In these transitions, 
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the edge may be different shapes, such as a straight line, a wedge, or a zigzag. 
The first subtype listed for each type in the following table is the default. 


Edge Wipe Transition Effects 


Type Subtype SMPTE. Transition Appearance 
: leftToRight 1 A bar moves from left to right. 
barWipe 
topToBottom 2 A bar moves from top to bottom. 
topLeft 3 A box expands from the upper-left 
corner to the lower-right corner. 
topRight 4 A box expands from the upper-right 
corner to the lower-left corner. 
bottomRight i) A box expands from the lower-right 
corner to the upper-left corner. 
bottomLeft 6 A box expands from the lower-left 
: corner to the upper-right corner. 
boxWipe 
topCenter 23 A box expands from the top edge’s 
midpoint to the bottom corners. 
rightCenter 24 A box expands from the right edge’s 
midpoint to the left corners. 
bottomCenter 25 A box expands from the bottom edge’s 
midpoint to the top corners. 
leftCenter 26 A box expands from the left edge’s 
midpoint to the right corners. 
cornersIn 7 A box shape expands from each of the 
four corners toward the center. 
fourBoxWipe | cornersOut 8 A box shape expands from the center of 
each quadrant toward the corners of 
each quadrant. 
vertical 21 A central, vertical line splits and expands 
toward the left and right edges. 
horizontal 22 A central, horizontal line splits and 
expands toward the top and bottom 
edges. 
barnDoorWipe | diagonalBottom | 45 A diagonal line from the lower-left to 
Left upper-right corners splits and expands 
toward the opposite corners. 
diagonalTopLeft | 46 A diagonal line from upper-left to lower- 


right corners splits and expands toward 
the opposite corners. 
(Table Page 1 of 3) 
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Edge Wipe Transition Effects (continued) 
Type Subtype SMPTE. Transition Appearance 


topLeft 41 A diagonal line moves from the upper- 
left corner to the lower-right corner. 


diagonalWipe - - - 
topRight 42 A diagonal line moves from the upper 


right corner to the lower-left corner. 


vertical 43 Two wedge shapes slide in from the top 
and bottom edges toward the center. 


bowTieWipe Tae 
horizontal 44 Two wedge shapes slide in from the left 


and right edges toward the center. 


doubleBarnDoor | 47 Four wedge shapes split from the center 
and retract toward the four edges. 


miscDiagonal | doubleDiamond 48 A diamond connecting the four edge 
Wipe midpoints simultaneously contracts 
toward the center and expands toward 


the edges. 


down 61 A wedge shape moves from top to 
bottom. 


; left 62 A wedge shape moves from right to left. 
veeWipe a 
up 63 A wedge shape moves from bottom to 


top. 


right 64 A wedge shape moves from left to right. 


down 65 A “V” shape extending from the bottom 
edge’s midpoint to the opposite corners 
contracts toward the center and expands 
toward the edges. 


left 66 A “V” shape extending from the left 
edge’s midpoint to the opposite corners 
contracts toward the center and expands 


toward the edges. 
barnVee Wipe mm 
up 67 A “V” shape extending from the top 


edge’s midpoint to the opposite corners 
contracts toward the center and expands 
toward the edges. 


right 68 A “V” shape extending from the right 
edge’s midpoint to the opposite corners 
contracts toward the center and expands 
toward the edges. 


(Table Page 2 of 3) 
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Edge Wipe Transition Effects (continued) 


Type Subtype SMPTE Transition Appearance 
leftToRight Zl A zigzag shape moves from left to right. 
zipZagWipe topToBottom 72 A zigzag shape moves from top to 
bottom. 
vertical 73 The vertical, central line splits in a 
zigzag pattern and moves toward the 
barnZigZag left and right edges. 
Wipe horizontal 74 The horizontal, central line splits in a 


Iris Wipe Transition Effects 


zigzag pattern and moves toward the 
top and bottom edges. 
(Table Page 3 of 3) 


A transition effect in the iris wipe family reveals a clip through an expanding 
shape. For example, a star can expand from the center of the transition area to 
reveal a new clip. The first subtype listed for each type in the following table is 


the default. 
Iris Wipe Transition Effects 
Type Subtype SMPTE. Transition Appearance 
rectangle 101 A rectangle expands from the center. 
irisWipe diamond 102 A four-sided diamond expands from the 
center. 
up 103 A triangle pointed toward the top edge 
expands from the center. 
right 104 A triangle pointed toward the right edge 
: . expands from the center. 
triangleWipe ; ; 
down 105 A triangle pointed toward the bottom edge 
expands from the center. 
left 106 A triangle pointed toward the left edge 
expands from the center. 


(Table Page 1 of 2) 
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Iris Wipe Transition Effects (continued) 


Type Subtype SMPTE Transition Appearance 
up 107 An arrowhead shape pointed toward the top 
edge expands from the center. 
right 108 An arrowhead shape pointed toward the 
; right edge expands from the center. 
arrowHeadWipe : 
down 109 An arrowhead shape pointed toward the 
bottom edge expands from the center. 
left 110 An arrowhead shape pointed toward the left 
edge expands from the center. 
up 111 A pentagon pointed toward the top edge 
: expands from the center. 
pentagonWipe 5 
down 112 A pentagon pointed toward the bottom edge 
expands from the center. 
horizontal | 113 A hexagon with flat sides at top and bottom 
‘ expands from the center. 
hexagonWipe 5 - - - 
vertical 114 A hexagon with flat sides at left and right 
expands from the center. 
circle 119 A circle expands from the center. 
ellipseWipe horizontal | 120 A horizontal ellipse expands from the center. 
vertical 121 A vertical ellipse expands from the center. 
horizontal | 122 An eye shape, its corners pointing left and 
; right, expands from the center. 
eyeWipe ; Z ae: 
vertical 123 An eye shape, its corners pointing up and 
down, expands from the center. 
horizontal | 124 A horizontal rectangle with rounded corners 
; expands from the center. 
roundRectWipe . ; ; 
vertical 125 A vertical rectangle with rounded corners 
expands from the center. 
fourPoint 127 A four-pointed star expands from the center. 
starWipe fivePoint 128 A five-pointed star expands from the center. 
sixPoint 129 A six-pointed star expands from the center. 
: ; heart 130 A heart shape expands from the center. 
miscShapeWipe 
keyhole 131 A keyhole shape expands from the center. 


(Table Page 2 of 2) 
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The clock wipe family includes transition effects in which a clip is revealed by a 
radial sweep, similar to the second hand sweeping around the face of a clock. 
The first subtype listed for each type in the following table is the default. 


Clock Wipe Transition Effects 


Type Subtype SMPTE Transition Appearance 
clockwiseTwelve 201 A radial hand sweeps clockwise 
from the twelve o’clock position. 
clockwiseThree 202 A radial hand sweeps clockwise 
from the three o’clock position. 
clockWipe — . ; 
clockwiseSix 203 ‘| A radial hand sweeps clockwise 
from the six o’clock position. 
clockwiseNine 204 A radial hand sweeps clockwise 
from the nine o’clock position. 
twoBladeVertical 205 Two radial hands sweep clockwise 
from the twelve and six o’clock 
positions. 
pinWheelWipe twoBladeHorizontal | 206 | Two radial hands sweep clockwise 
from the nine and three o’clock 
positions. 
fourBlade 207 Four radial hands sweep clockwise. 
centerTop 211 A fan unfolds from the top edge, 
the fan axis at the center. 
centerRight 212 A fan unfolds from the right edge, 
the fan axis at the center. 
top 231 A fan unfolds from the bottom, the 
fan axis at the top edge’s midpoint. 
fanWipe . 
right 232 A fan unfolds from the left, the fan 
axis at the right edge’s midpoint. 
bottom 233 A fan unfolds from the top, the fan 
axis at the bottom edge’s midpoint. 
left 234 A fan unfolds from the right, the 


fan axis at the left edge’s midpoint. 
(Table Page 1 of 4) 
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Clock Wipe Transition Effects (continued) 


Type Subtype SMPTE Transition Appearance 
fanOutVertical 213 Two fans, their axes at the center, 
unfold from the top and bottom. 
fanOutHorizontal 214 Two fans, their axes at the center, 
. unfold from the left and right. 
doubleFanWipe 5 ; 
fanInVertical 235 Two fans, their axes at the top and 
bottom, unfold from the center. 
fanInHorizontal 236 Two fans, their axes at the left and 
right, unfold from the center. 
clockwiseTop 221 A radial hand sweeps clockwise 
from the top edge’s midpoint. 
clockwiseRight 222 A radial hand sweeps clockwise 
from the right edge’s midpoint. 
clockwiseBottom 223 A radial hand sweeps clockwise 
from the bottom edge’s midpoint. 
clockwiseLeft 224 A radial hand sweeps clockwise 
from the left edge’s midpoint. 
singleSweepWipe clockwiseTopLeft 241 A radial hand sweeps clockwise 
from the upper-left corner. 
counterClockwise 242 A radial hand sweeps counter- 
BottomLeft clockwise from the lower-left 
corner. 
clockwiseBottom 243 A radial hand sweeps clockwise 
Right from the lower-right corner. 
counterClockwise 244 A radial hand sweeps counter- 
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TopRight 


clockwise from the upper-right 
corner. 
(Table Page 2 of 4) 


Type 


doubleSweepWipe 
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Clock Wipe Transition Effects (continued) 


Subtype 
parallelVertical 


SMPTE Transition Appearance 


225 


Two radial hands sweep clockwise 
and counter-clockwise from the top 
and bottom edges’ midpoints. 


parallelDiagonal 


226 


Two radial hands sweep clockwise 
and counter-clockwise from the left 
and right edges’ midpoints. 


oppositeVertical 


227 


Two radial hands attached at the 
top and bottom edges’ midpoints 
sweep from right to left. 


oppositeHorizontal 


parallelDiagonal 
TopLeft 


228 


245 


Two radial hands attached at the 
left and right edges’ midpoints 
sweep from top to bottom. 


Two radial hands attached at the 
upper-left and lower-right corners 
sweep down and up. 


parallelDiagonal 
BottomLeft 


246 


Two radial hands attached at the 
lower-left and upper-right corners 
sweep down and up. 


saloonDoorWipe 


top 


251 


Two radial hands attached at the 
upper-left and upper-right corners 
sweep down. 


left 


252 


Two radial hands attached at the 
upper-left and lower-left corners 
sweep to the right. 


bottom 


253 


Two radial hands attached at the 
lower-left and lower-right corners 
sweep up. 


right 


254 


Two radial hands attached at the 
upper-right and lower-right corners 
sweep to the left. 

(Table Page 3 of 4) 
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Type 


windshieldWipe 


Clock Wipe Transition Effects (continued) 


Subtype 
right 


SMPTE Transition Appearance 


261 


Two radial hands attached at the 
midpoints of the top and bottom 
halves sweep from right to left. 


up 


262 


Two radial hands attached at the 
midpoints of the left and right 
halves sweep from top to bottom. 


vertical 


263 


Two sets of radial hands attached at 
the midpoints of the top and 
bottom halves sweep from top to 
bottom and bottom to top. 


horizontal 


Matrix Wipe Transition Effects 


264 


Two sets of radial hands attached at 
the midpoints of the left and right 
halves sweep from left to right and 
right to left. 

(Table Page 4 of 4) 


The matrix wipe family includes transition effects in which a clip is revealed by 


a series of sequential tiles that follow a pattern, such as a spiral. In the 


following table, the first subtype listed for each type is the default. 


Matrix Wipe Transition Effects 


Type Subtype SMPTE. Transition Appearance 
topLeftHorizontal 301 Tiles move in a horizontal zigzag 
from the upper-left corner. 
topLeftVertical 302 Tiles move in a vertical zigzag from 
the upper-left corner. 
topLeftDiagonal 303 Tiles move in a diagonal zigzag 
from the upper-left corner. 
snakeWipe - - - - - - 
topRightDiagonal 304 Tiles move in a diagonal zigzag 
from the upper-right corner. 
bottomRightDiagonal | 305 Tiles move in a diagonal zigzag 
from the lower-right corner. 
bottomLeftDiagonal | 306 Tiles move in a diagonal zigzag 
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from the lower-left corner. 
(Table Page 1 of 4) 


Type 


spiralWipe 
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Matrix Wipe Transition Effects (continued) 


Subtype SMPTE. Transition Appearance 
topLeftClockwise 310 Tiles spiral clockwise from the 
upper-left corner. 
topRightClockwise 311 Tiles spiral clockwise from the 
upper-right corner. 
bottomRightClockwise | 312 Tiles spiral clockwise from the 
lower-right corner. 
bottomLeftClockwise | 313 Tiles spiral clockwise from the 
lower-left corner. 
topLeft 314 Tiles spiral counter-clockwise from 
CounterClockwise the upper-left corner. 
topRight 315 Tiles spiral counter-clockwise from 
CounterClockwise the upper-right corner. 
bottomRight 316 Tiles spiral counter-clockwise from 
CounterClockwise the lower-right corner. 
bottomLeft 317 Tiles spiral counter-clockwise from 
CounterClockwise the lower-left corner. 


(Table Page 2 of 4) 
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Type 


parallelSnakes 
Wipe 


Matrix Wipe Transition Effects (continued) 


Subtype 
verticallopSame 


SMPTE. Transition Appearance 


320 


Tiles move in two vertical zigzags, 
lines headed the same direction, 
starting from the upper-left and 
upper-right corners. 


verticalBottomSame 


321 


Tiles move in two vertical zigzags, 
lines headed the same direction, 
starting from the lower-left and 
lower-right corners. 


verticalTopLeft 
Opposite 


322 


Tiles move in two vertical zigzags, 
lines headed opposite directions, 
starting from the upper-left and 
lower-right corners. 


verticalBottomLeft 
Opposite 


323 


Tiles move in two vertical zigzags, 
lines headed opposite directions, 
starting from the lower-left and 
upper-right corners. 


horizontalLeftSame 


horizontalRightSame 


324 


325 


Tiles move in two horizontal 
zigzags, lines headed the same 
direction, starting from the upper- 
left and lower-left corners. 


Tiles move in two horizontal 
zigzags, lines headed the same 
direction, starting from the upper- 
right and lower-right corners. 


horizontalTopLeft 
Opposite 


326 


Tiles move in two horizontal 
zigzags, lines headed opposite 
directions, starting from the 
upper-left and lower-right corners. 


horizontalTopRight 
Opposite 


327 


Tiles move in two horizontal 
zigzags, lines headed opposite 
directions, starting from the 
upper-right and lower-left corners. 


diagonalBottomLeft 
Opposite 


328 


Two tile zigzags move outward in 
opposite directions from the 
diagonal line connecting the lower- 
left and upper-right corners. 


diagonalTopLeft 
Opposite 


329 


Two tile zigzags move outward in 
opposite directions from the 
diagonal line connecting the 
upper-left and lower-right corners. 
(Table Page 3 of 4) 
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Matrix Wipe Transition Effects (continued) 


Subtype 
twoBoxTop 


SMPTE. Transition Appearance 


340 


Two lines of tiles spiral inward, 
starting in the upper corners and 
moving vertically. 


twoBoxBottom 


341 


Two lines of tiles spiral inward, 
starting in the lower corners and 
moving vertically. 


twoBoxLeft 


342 


Two lines of tiles spiral inward, 
starting in the left corners and 
moving horizontally. 


twoBoxRight 


fourBoxVertical 


343 


344 


Two lines of tiles spiral inward, 
starting in the right corners and 
moving horizontally. 


Four lines of tiles spiral inward, 


starting in the four corners and 
moving vertically. 


fourBoxHorizontal 


345 


Four lines of tiles spiral inward, 
starting in the four corners and 
moving horizontally. 


waterfallWipe 


Fade, Push, and Slide Transition Effects 


verticalLeft 


350 


Tiles cascade vertically from the 
left in a waterfall effect. 


verticalRight 


351 


Tiles cascade vertically from the 
right in a waterfall effect. 


horizontalLeft 


352 


Tiles cascade horizontally from the 
left in a waterfall effect. 


horizontalRight 


353 


Tiles cascade horizontally from the 
right in a waterfall effect. 
(Table Page 4 of 4) 


This transition family, which has no corresponding SMPTE codes, includes 


fades that let you blend images into one another, or fade an image into or out 


of a solid color. The push and wipe transition effects allow a second clip to 
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push the first clip out of the way, or to slide over it. In the following table, the 
first subtype for a certain type is the default. 


Fade, Push, and Slide Transition Effects 


Type Subtype Transition Appearance 
crossfade The clip fades into the clip that follows it. 
fade fadeFromColor | The clip fades in from a solid color. 


fadeToColor The clip fades out into a solid color. 


fromLeft The clip pushes out the preceding clip from left to right. 
sani fromRight The clip pushes out the preceding clip from right to left. 
sta Wi eae a ea hc ear tS CM CE 
: y fromTop The clip pushes out the previous clip from top to bottom. 


fromBottom The clip pushes out the previous clip from bottom to top. 


fromLeft The clip slides over the preceding clip from left to right. 
a fromRight The clip slides over the preceding clip from right to left. 
Lic Wi pe MEER ta a Ta aa EN SBR EE 
P fromTop The clip slides over the previous clip from top to bottom. 


fromBottom | The clip slides over the previous clip from bottom to top. 


Note: Push wipe transition effects are not currently functional 
in RealOne Player. 


For More Information: With color fades, see See “Defining 
Colors and Border Blends” on page 410 for information on 
color values. 


Modifying Transition Effects 
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The following sections describe optional <transition/> tag attributes that 
modify the appearance of the transition effects. The following table 
summarizes these attributes. 


Attributes for Modifying Transition Effects 


Attribute Value Default Function Reference 

borderColor | blend| black | Defines the border color. page 410 
color_value 

borderWidth | pixels 0 Specifies the border size. page 410 

direction forward| forward | Sets the direction of movement. _| page 407 
reverse 


(Table Page 1 of 2) 
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Attributes for Modifying Transition Effects (continued) 


Attribute Value Default Function Reference 
dur time_value | 1s Specifies the effect duration. page 407 
endProgress |0.0-1.0 1.0 Halts the effect before it finishes. | page 408 
fadeColor color_value | black Sets the color for fade transitions. | page 410 
horzRepeat | integer 1 Multiplies the effect horizontally. | page 409 
startProgress | 0.0-1.0 0.0 Starts the effect at a midway point. | page 408 
vertRepeat | integer il Multiplies the effect vertically. page 409 


(Table Page 2 of 2) 


Setting a Transition Effect’s Duration 


By default, each transition effect lasts one second, but you can change this by 
adding a dur attribute to the <transition/> tag. As described in “Timelines and 
Transition Effects” on page 392, changing a transition effect’s duration does 
not affect the presentation duration. In the following example, the transition 
effect takes three seconds to complete: 


<transition id="fade1” type="fade” subtype="crossfade” dur="3s” /> 
To use the same transition type but vary the transition speeds, define the 
transition multiple times, each time with a different ID and duration. For 


example, the following tags define the same transition type and subtype, but 
the first effect lasts two seconds whereas the second effect lasts four seconds: 
<transition id="fan1” type="fanWipe” subtype="top” dur="2s”" /> 
<transition id="fan2” type="fanWipe” subtype="top” dur="4s”" /> 


For More Information: The dur attribute uses the standard SMIL 
timing values, which are described in “Specifying Time Values” 
on page 313. 


Reversing a Transition Effect’s Direction 


Using direction=“reverse”, you can change the direction a transition effect runs. 
For example, the following transition effect reveals the clip in a four-point star 
that expands outward: 


<transition id="p1” type="starWipe” subtype="fourPoint”/> 
Reversing the direction creates a four-point star that contracts inward: 


<transition id="p2” type="starWipe” subtype="fourPoint” direction="reverse” /> 
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For some transition effects, you can simply use a different subtype rather than 
include the attribute direction="reverse”. For example, this transition effect: 


<transition id="p3” type="pushWipe” subtype="fromRight” /> 


is equivalent to this transition effect: 


<transition id="p4” type="pushWipe” subtype="fromLeft” direction="reverse” /> 


Note: Reversing the direction of a transition effect that has no 
specific starting or ending point, such as crossfade, has no 
visual effect. 


Using Partial Transition Effects 


Each transition effect has a starting appearance and an ending appearance. 
For example, an expanding star transition normally starts as a single point in 
the center of the transition area. It ends after the star has expanded out of the 
transition area. You can set a different point where a transition effect starts 
with startProgress: 


<transition id="wipe1” type="pushWipe” subtype="fromLeft” startProgress="0.25" /> 


The startProgress attribute takes a value from 0.0 (normal starting point) to 1.0 
(normal ending point). This value represents a percentage. For example, 
startProgress="0.25”" means that when the transition effect starts, it appears to 
be 25 percent complete already. It then flows to its end point over the course 
of its specified duration. 


Additionally, you can use endProgress, which also takes a value from 0.0 to 1.0 
to indicate how far the transition effect progresses before it ends. The 
following example defines a keyhole-shape transition effect that ends when 
the keyhole has expanded to half of its normal ending size: 


<transition id="key” type="miscShapeWipe” subtype="keyhole” endProgress="0.5” /> 


Tips for Using Partial Transition Effects 


+ When you use endProgress, the transition effect ends in an intermediate 
state. You can use this to create special effects with iris wipes, for example. 
With other types of transition effects, though, a partially completed 
transition may confuse the viewer. 


- You can combine the startProgress and endProgress attributes in a single 
<transition/> tag. When you do this, the endProgress value must be equal 
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to, or higher than, the startProgress value for the transition effect to 
exhibit any movement. 


+ If you set the startProgress and endProgress attributes to the same value ina 
<transition/> tag, the transition effect appears to complete instantly, 
regardless of its duration. 


+ When you use a partial transition effect to introduce a new clip ina 
sequence, the preceding clip’s fill attribute determines whether parts of 
that clip remain visible at the end of the effect. Use one of the following: 


+ fill-“hold” to keep the first clip visible 


+ fill=“transition” to make the first clip disappear after the transition 
completes 


+ fill-“remove” to make the first clip disappear before the transition 
begins 


For More Information: See “Using Clip Fills with Transition 
Effects” on page 412 for more information. 


Repeating Transition Effects Horizontally or Vertically 


When you repeat a transition effect, the effect appears multiple times instead 
of just once. For example, an expanding star transition effect normally begins 
in the center of the clip and expands toward the clip’s edges. By repeating this 
effect twice horizontally and twice vertically, you make a separate star shape 

expand in each of the clip’s quadrants, as shown in the following illustration. 


Repeating Star Transition Effect 


You repeat a transition effect by adding the horzRepeat or vertRepeat attribute 
to a <transition/> tag. Each attribute takes as a value a positive integer that 
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defines how many times the transition effect repeats horizontally or vertically, 
respectively. For example, the following transition effect defines two four- 
point stars that appear side-by-side: 


<transition id="starHorz” type="starWipe” subtype="fourPoint” horzRepeat=”"2” /> 
To have these stars appear one on top of the other, you repeat the effect 
vertically: 

<transition id="starVert” type="starWipe” subtype="fourPoint” vertRepeat=" 2” /> 
You can combine horzRepeat and vertRepeat attributes in the same tag. The 


following example creates a grid of nine transition effects by defining three 
horizontal repetitions and three vertical repetitions: 

<transition id="nineStar” type="starWipe” subtype="fourPoint” horzRepeat="3” 
vertRepeat="3" /> 


Tip: Think of these attributes as defining a table. The 
horzRepeat attribute defines the number of columns, and the 
vertRepeat attribute defines the number of rows. 


Setting a Border Width 


All transition effects except fades have borders. When a clip slides over another 
clip from left to right, for example, the border is the new clip’s right edge. By 
default, the border width is 0 (zero), meaning the border is not accentuated. 
By adding a borderWidth attribute to a <transition/> tag, you can make the 
border more apparent. This attribute takes as a value a positive integer that 
sets the border’s pixel width. The following example sets a two-pixel border 
width: 

<transition id="wipe1” type="pushWipe” subtype="fromLeft” borderWidth=" 2” /> 


By default, the border is black, but you can use any other RGB color. You can 
also make the border blend the clip with its background. The following 
section explains how to do this. 


Defining Colors and Border Blends 


Transition effects that fade to or from a color, as well as transition effects that 
set border widths, can include color values, which are described in Appendix 
C. The following example defines a transition effect in which the clip fades to 
a solid red: 


<transition id="redFade” type="fade” subtype="fadeToColor” fadeColor="red” /> 
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If you define a border width as described in the preceding section, you can use 
the borderColor attribute to set the border color: 


<transition id="wipel” type="pushWipe” subtype="fromLeft” borderWidth="2” 
borderColor="#AFBC08” /> 


Alternatively, you can use borderColor="blend” to make the border blend the 
clip into its background. This typically creates a blurring effect along the 
border: 


<transition id="wipe1” type="pushWipe” subtype="fromLeft” borderWidth="16” 
borderColor=" blend” /> 


Tip: When using borderColor=“blend”, you typically need to set 
borderWidth to 10 pixels or higher to notice the blending effect. 


Assigning Transition Effects to Clips 


After you define <transition/> tags in the SMIL file header, you assign the 
transition effects to clips using transIn and transOut attributes in each clip 
source tag. You can assign transition effects only to clip source tags, not to 
<seq>, <par>, or <excl> groups. Any type of clip can use a transition, but 
because transitions are visual, they do not affect a clip’s audio track. 


The transIn attribute makes the transition effect occur as the clip starts to 
play. The transOut attribute makes the effect occur as the clip finishes playing. 
Each attribute takes as a value the ID defined in a <transition/> tag. For 
example, suppose that you define the following two transition effects: 


<transition id="fromBlue” type="fade” subtype="fadeFromColor” fadeColor="blue”/> 
<transition id="toBlue” type="fade” subtype="fadeToColor” fadeColor="blue”/> 


In the SMIL file body, you could the assign the effects to a sequence of two 
videos like this: 
<seq> 

<video src="videol.rm” transIn="fromBlue” transOut="toBlue” .../> 

<video src="video2.rm” transIn="fromBlue” transOut="toBlue” .../> 


</seq> 

In the preceding example, each video fades up from a solid blue when it starts, 
then fades down to solid blue when it ends. It’s not necessary to use both the 
transIn and transOut attributes for each clip, though. In the following example, 
the first video starts playing without any transition. As the first clip ends and 
the second clip starts, there’s a fade to blue and then a fade up. When the 
second clip stops playback, it disappears from the screen: 
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<seq> 

<video src="videol.rm” transOut="toBlue” /> 

<video src="video2.rm” transIn="fromBlue” fill="remove”/> 
</seq> 


Note: A transition effect assigned with a transOut attribute 
always obeys SMIL timing rules. If a video normally plays for 
two minutes, but has a dur="3min” value to lengthen its active 
period, the transition effect occurs after three minutes. 


Using Clip Fills with Transition Effects 


The section “Setting a Fill” on page 327 explains the fill attribute, which 
makes the clip disappear or remain visible when it finishes playing. Which 
values you use for fill can also affect transition effects. The following sections 
explain how best to use the fill attribute with transition effects. 


Defining a Transition Fill for a Sequence of Clips 


When you apply transition effects to a sequence of clips, use fill="transition” to 
keep a clip onscreen long enough for a transition to occur. The transition value 
does nothing when a transition is not applied to the clip. Suppose you want to 
use a three-second radial wipe like the following to introduce each new video 
in a sequence: 


<transition id="fan1” type="fanWipe” subtype="top” dur="3s"/> 


You could apply this transition effect to the beginning of each clip. Ina 
standard sequence of clips, though, each clip disappears as soon as it stops 
playing. The transition effect that introduces the next clip therefore operates 
against the region’s background color. To keep clips onscreen during 
transitions, add fill="transition” to each clip’s source tag: 
<seq> 

<video src="videol.rm” transIn="fan1” fill="transition” /> 

<video src="video2.rm” transIn="fan1” fill="transition” /> 

...more clips that use fill="transition”... 

<video src="video6.rm” transIn="fan1” fill="remove” /> 
</seq> 


In this sequence, each fill="transition” attribute keeps the clip onscreen for 
three seconds (the duration of the transition effect) after the clip ends 
playback, long enough for the transition effect to complete. This does not 
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lengthen the presentation timeline. The three seconds used for each transition 
effect overlap the first three seconds that each new clip plays. 


Note: If a clip in a sequence uses a begin value to delay its 
playback, a fill="transition” value in the preceding clip freezes 
that clip until the clip with the begin value starts to play and 
the transition effect completes. For more on begin, see “Using a 
Begin Time with a Clip” on page 315. 


Tip: In a long sequence of clips, add fillDefault="transition” to 
the <seq> tag. You do not then need to add fill=“transition” to 
every clip tag. For more on fillDefault, see “Specifying a Default 
Fill” on page 334. 


Setting a Fill in Parallel Groups 


When you use parallel groups, a fill="transition”, fill="remove” or fill=“freeze” 
attribute in a clip source tag can affect when a transition occurs. Suppose that 
you define a two-second fade to black: 


<transition id="toBlack” type="fade” subType="fadeToColor” dur="2s”"/> 


You next apply this transition to both an image and a video playing in parallel. 
In the following example, the image clip has a fill="remove” attribute and a 30- 
second duration. The clip begins to fade out at 28 seconds into the parallel 
group’s timeline, disappearing much sooner than the video, which has a 154- 
second duration: 


<par> 
<img src=”...” region="image” transOut="toBlack” fill="remove" dur="30s”"/> 
<video src="...” region="video” transOut="toBlack” dur="154s"/> 

</par> 


To make the image fade out only after its duration has elapsed, you would use 
fill=“transition” as shown in the following example. In this case, the image 
disappears 32 seconds after it begins to play: 


<par> 
<img src="...” region="image” transOut="toBlack” fill="transition” dur="30s”"/> 
<video src="...” region="video” transOut="toBlack” dur="154s"/> 

</par> 


To make the image begin to fade out two seconds before the video finishes 
playing, you would use fill=“freeze” as shown in the following example: 
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<par> 
<img src="...” region="image” transOut="toBlack” fill="freeze” dur="30s”"/> 
<video src="...” region="video” transOut="toBlack” dur="154s"/> 

</par> 


Transition Effects Examples 


The following sections illustrate how to use transition tags and attributes to 
create various transition effects. To see more examples, get the zipped HTML 
version of this guide as described in “How to Download This Guide to Your 
Computer” on page 12, and view the Sample Files page. 


Fading to a Color Between Clips 


One of the simplest transition effects is to fade up from or down to a color. 
The following example shows a sequence of two videos. There is a two-second 
fade from blue as each video starts, and a two-second fade to blue when each 
video ends. Each video is centered within the video region and appears at its 
normal size. A begin="2s" value is used with each video to insert a short delay 
before each transition occurs: 


<smil xmlns=“http://www.w3.org/2001/SMIL20/Language”> 
<head> 
<layout> 
<root-layout width="320" height="240" backgroundColor="blue"/> 
<region id="video_region"/> 
<regPoint id="middle" left="50%" top="50%" regAlign="center" /> 
</layout> 
<transition id="fromBlue" type="fade" subtype="fadeFromColor" 
fadeColor="blue" dur="2s"/> 
<transition id="toBlue" type="fade" subtype="fadeToColor" 
fadeColor="blue" dur="2s"/> 
</head> 
<body> 
<seq> 
<video src="video2.rm" region="video_region" regPoint="middle" 
transIn="fromBlue" transOut="toBlue" begin="2s" fill="remove"/> 
<video src="video1.rm" region="video_region" regPoint="middle" 
transIn="fromBlue" transOut="toBlue" begin="2s" fill="remove"/> 
</seq> 
</body> 
</smil> 
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Crossfading Videos 


In a simple variation of the preceding example, the first video fades up from 
green when it starts to play, and the second video fades down to green when it 
ends. When the first video stops and the second video starts, though, the two 
videos crossfade into each other. Clips do not need to be the same size to 
crossfade into each other: 


<smil xmlns=“http://www.w3.org/2001/SMIL20/Language”> 
<head> 
<meta name="title" content="Crossfading Videos"/> 
<meta name="author" content="RealNetworks, Inc."/> 
<meta name="copyright" content="(c)2002 RealNetworks, Inc."/> 
<layout> 
<root-layout width="360" height="280" backgroundColor="#87CF87"/> 
<region id="video_region" width="320" height="240" left="20" top="20"/> 
<regPoint id="middle" left="50%" top="50%" regAlign="center" /> 
</layout> 
<transition id="fromGreen" type="fade" subtype="fadeFromColor" 
fadeColor="#87CF87" dur="2s"/> 
<transition id="toGreen" type="fade" subtype="fadeToColor" fadeColor="#87CF87" 
dur="2s"/> 
<transition id="xFade" type="fade" subtype="crossfade" dur="2s"/> 
</head> 
<body> 
<seq> 
<video src="video2.rm" region="video_region" transIn="fromGreen" begin="2s" 
fill="transition" regPoint="middle"/> 
<video src="video3.rm" region="video_region" transIn="xFade" transOut="toGreen" 
fill="remove" regPoint="middle"/> 
</seq> 
</body> 
</smil> 
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CHAPTER 


17 


ANIMATIONS 


Using SMIL animations, you can transform clips by expanding 
them, for example, or moving them around the screen. To use this 
advanced SMIL feature, you must thoroughly understand clip tags, 
groups, timing, and layouts as described in the preceding chapters. 
For information on Flash animation rather than SMIL animation, 


see Chapter 5. 


Tip: To see animation examples, get the zipped HTML version 
of this guide as described in “How to Download This Guide to 
Your Computer” on page 12, and view the Sample Files page. 


Understanding Animations 


SMIL animations provide the means for manipulating clips playing in 
RealOne Player. They are not themselves distinct clips. Instead, they are SMIL 
tags and attributes that instruct RealOne Player to modify a clip, whether a 
video, a still image, a brush object, or any other type of clip. You can even apply 
a SMIL animation to a Flash animation clip to “animate an animation.” 
Common uses of SMIL animation include: 


- enlarging or shrinking a clip, 

* moving a clip around the screen, 

- changing a region’s background color, 

+ boosting or cutting a clip’s sound level, and 


- altering a clip’s transparency to make it more, or less, opaque. 


Tip: Chapter 16 explains transition effects, which are special 
effects that occur when a clip starts or stops playing. You can 
use transition effects and animations in the same presentation. 
You can even apply them to the same clip. But you define them 
separately. 
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Animation Tags 


You can add an animation to your SMIL presentation using any one of four 
animation tags: 
* <animate/> 
The <animate/> tag is the principal tag used to create animations. The 
other tags are variations of the <animate/> tag, so once you learn how to 
use <animate/>, you will master the other tags quickly. The section 
“Creating Basic Animations” on page 421 explains the main attributes 
and values of the <animate/> tag. 


<animateColor/> 

The <animateColor/> tag is a variation of the <animate/> tag that works for 
color animations only. See the section “Animating Colors” on page 434 for 
more on this tag. 


<animateMotion/> 

The <animateMotion/> tag lets you move a clip both horizontally and 
vertically at the same time. A single <animate/> tag creates motion in only 
one direction. Thus, a single <animateMotion/> tag can do the work of two 
<animate/> tags. The section “Creating Horizontal and Vertical Motion” 
on page 435 explains how to use this tag. 


<set/> 

The <set/> tag instantly sets an animation. With an <animate/> tag, you 
can widen a region over the course of several seconds, for example. With 
the <set/> tag, in contrast, you can set the new width instantly. The 
section “Setting an Attribute Value” on page 436 describes the <set/> tag. 


Tip: Do not confuse the SMIL animation tags with the 
<animation/> tag, which is a clip source tag that introduces an 
animation clip into a presentation. For more on <animation/>, 
see “Creating Clip Source Tags” on page 209. 


Animation Tag Placement 


Animation tags always appear in the SMIL <body> section, even when they 
modify elements defined in the SMIL header, such as <region/> tags. 
Animation tags function much like clip source tags. You can place them in 
groups, but you can also include them within clip source tags. The following 
sections describe the various means of adding animation tags to a SMIL file. 


CHAPTER 17: Animations 


In a Clip Source Tag 


When you want to animate a clip as it plays, you can turn the clip source tag 
into a binary tag, as shown in the following example: 


<video ...> 
<animate ...animation for the video clip or region.../> 
</video> 


In this case, the animation typically affects the clip or the region playing the 
clip. The animation can occur only while the clip is playing or appears frozen 
onscreen. Non-interactive timing attributes in the animation tag are relative 
to the start of clip playback. For example, a begin="5s" attribute in the 
animation tag starts the animation five seconds after the clip begins to play. 


For More Information: See “Binary and Unary Tags” on page 201 
for the basics of modifying a clip source tag to include other 
SMIL elements. 


In a Parallel Group 


Because animations function like clip source tags, you can place them in 
parallel groups with other clips, as shown in the next example: 
<par> 
<video.../> 
<textstream.../> 
<animate ...animation for any SMIL element.../> 
</par> 


In this case, the animation might apply to a clip in the same parallel group, or 
to any other element in the file. The animation plays only while its <par> 
group is active, however, and non-interactive timing attributes in the 
animation tag are relative to the start of the <par> group. For example, a 
begin="10s" attribute in the animation tag starts the animation 10 seconds 
after the group becomes active. 


In a Sequence 
Although not as common as the preceding cases, an animation can also be 
part of a sequence as shown here: 


<seq> 

<video ... fill="hold”/> 

<animate ...animation for the preceding clip.../> 
</seq> 
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Although a sequential animation can affect any SMIL element, it typically 
targets the preceding clip. Because the animation plays only when the 
preceding clip finishes, that clip typically uses fill=“hold” to keep it from 
disappearing when it ends playback. Non-interactive timing attributes in the 
animation tag are relative to the end of the preceding clip. For example, a 
begin="3s" attribute in the animation tag starts the animation three seconds 
after the preceding clip finishes. 


SMIL Timing with Animations 


Because animations function like clip source tags, you can use SMIL timing 
attributes to control when animations start, and how long they last. The 
following are the most common timing attributes used with animations: 
* begin 
The begin attribute, which is described in “Setting Begin and End Times” 
on page 314, controls when the animation starts, relative to the group or 
clip that contains the animation. If you do not use a begin value, the 
animation starts as soon as the clip or group that contains it becomes 
active. You can also use advanced begin times as described in Chapter 14 to 
start an animation when the screen pointer moves over a clip, for example. 


dur or end 


The dur or end attribute controls how long the animation lasts. As with 
any SMIL element, the end attribute works with begin to set a total 
playback time. For more information, see “Setting Durations” on page 
317, as well as “Choosing end or dur” on page 317. 

Fill 


The effects of an animation reset as soon as the animation’s duration 


elapses unless you use a fill attribute. If the animation is in a <par> group 
and you use fill="freeze”, for example, the animation holds its final 
appearance until the group ends. The fill attribute is described in “Setting 
a Fill” on page 327. 


repeatCount or repeatDur 


You can make an animation replay several times with repeatCount or 

repeatDur. (The SMIL 1.0 repeat attribute does not work with animations.) 
A repeating animation can also grow with each iteration. When widening 
a region, for example, you can make the region increase a certain amount 
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on each repetition. The attributes for making animations repeat are 


described in “Repeating an Element” on page 323. 


Simultaneous Animations 


Several animations can occur at the same time during a presentation, as long 


as they do not conflict. You cannot increase and decrease a region’s width at 


the same time, for example. But you can decrease its width, increase its height, 


move its left offset, and change its background color simultaneously by using 


several <animate/> tags that are active at the same time. 


Creating Basic Animations 


The <animate/> tag is the most versatile animation tag. You can use it to alter 


element sizes, positions, colors, and sound levels. The following table lists the 


attributes that you use to define animations with the <animate/> tag. Keep in 


mind, too, that animation tags typically use SMIL timing attributes, as 
described in “SMIL Timing with Animations” on page 420. 


<animate/> Tag Attributes 


Attribute Value Function Reference 
accumulate none|sum Makes a repeating animation build | page 432 
with each iteration. 
additive replace|sum Adds the animation value to the page 432 
existing value. 
attributeName | attribute_name Selects the attribute to animate. page 422 
by pixels |percentage| | Animates the element by a certain page 427 
color_value amount. Do not use with to. 
calcMode discrete|linear| Controls the flow of an animation. | page 429 
paced 
from pixels |percentage| | Sets a starting point for the page 426 
color_value animation. Use with to or by. 
targetElement | ID Identifies the tag that contains the | page 422 
animated attribute. 
to pixels |percentage| | Sets an end point for the animation. | page 426 
color_value Do not use with by. 
values pixels |percentage| | Defines a list of animation values. | page 428 


color_value 


Not used with from, to, or by. 
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Selecting the Element and Attribute to Animate 


Using the targetElement attribute, you specify the ID of the SMIL element you 
want to animate. Using attributeName you select a specific attribute within 
that element. To animate a region’s width, for example, you identify the region 
and its width attribute through an <animate/> tag in the SMIL body, as shown 
in the following example: 


<smil xmlns=“http://www.w3.org/2001/SMIL20/Language”> 
<head> 


<region id=“video_region” width="320" height="240"/> 


</head> 
<body> 


<animate targetElement="video_region” attributeName="width” .../> 
</body> 
</smil> 


When the animation is within a clip source tag, attributeName is required, but 
targetElement is not necessary. In the following example, the <animate/> tag 
falls within the clip source tag. The <animate/> tag does not therefore need a 
targetElement attribute to select the video clip for animation: 

<video ...> 


<animate attributeName=”...” .../> 
</video> 


Animating Window Attributes 


The following table describes the attributes that you can animate in <root- 
layout/> and <topLayout> tags. That is, you can use any of the following as 
values for attributeName when targetElement identifies an ID in a <root-layout/> 
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or <topLayout> tag. By animating these attributes, you can change the window 


size or alter its color. 


<root-layout/> and <topLayout> Attribute Values You Can Animate 


Attribute Effect Reference 
backgroundColor | Modifies the window’s background color. You could | page 290 
change the window’s background color from black to 
white midway through a presentation, for example. 
height Modifies the window height. You can animate this page 276 
attribute along with width to change the 
presentation’s display size. 
width Alters the window’s width. You can animate this page 276 


attribute along with height to change the 
presentation’s display size. 


Animating Region Attributes 


The next table lists all the attributes that you can animate in <region/> tags. In 
other words, you can use any of the following as values for attributeName when 
targetElement identifies a region ID. By animating these attributes, you can 


change a region’s size, move the region around a window, alter its color, or 


change the volume of a playing clip. 


Region Attribute Values You Can Animate 


Attribute Effect Reference 
backgroundColor | Modifies the region’s background color. You could page 290 
change the region’s background color from black to 
white midway through a presentation, for example. 
bottom Changes the region’s bottom offset. Animating this page 281 
attribute can make the region taller or shorter, as well 
as move it vertically. 
height Modifies the region height. You can animate this page 281 
attribute along with width to change a clip’s size. 
left Changes the region’s left offset. Animating this page 281 
attribute can change the region’s width, or move the 
region horizontally. 
regionName Moves a clip from region to region. page 280 
right Changes the region’s right offset. Animating this page 281 


attribute can make the region wider or narrower, as 
well as move it horizontally. 


(Table Page 1 of 2) 
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Region Attribute Values You Can Animate (continued) 


Attribute Effect Reference 


soundLevel Adjusts a clip’s sound level. You can animate this page 292 
attribute to fade the clip’s audio in or out. 


top Changes the region’s top offset. Animating this page 281 
attribute can make the region taller or shorter, as well 
as move it vertically. 


width Alters the region’s width. You can animate this page 281 
attribute along with height to change a clip’s size. 

z-index Changes the region’s stacking order. You can animate | page 288 
this attribute to bring one region in front of another 
region. 


(Table Page 2 of 2) 


Tips for Animating Regions 
- An attribute does not have to be explicitly declared to be animated. You 
can animate the region’s right attribute, for instance, even if that attribute 
is not defined in the <region/> tag. 


By animating the left, right, top, or bottom attributes, you can move the 
region around the <root-layout/> or the <topLayout> area. You can even 
move part or all of the region out of the display area. The region and any 
clips displaying in it are truncated at the window borders, however. 


If the animated region is a subregion (a region contained within another 
region), it will not display outside of the containing region. So if you 
move the subregion outside of its containing region, the subregion is 
truncated at the containing region’s borders. 


If you move a region over another region, the regions’ z-index values 
determine which region appears in front. You can also animate the z-index 
values to change this stacking order. 


Note: If region A appears in front of region B, you cannot 
animate a subregion in region B so that it appears in front of 
region A. For more information on subregion z-index values, 
see page 293. 


- A region’s fit attribute affects how a clip displays as a region’s height or 
width changes. For more on fit, see “Fitting Clips to Regions” on page 301. 


+ When you animate the size of a clip that includes a hot spot hyperlink, the 
link expands or contracts with the clip if the hyperlink has no coords 
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values, or its coordinates are defined with percentage values. Although the 
link does not change size if it is defined with pixel values, it is truncated if 
the region boundaries overlap the hot spot boundaries. 


For More Information: See “Defining Hot Spots” on page 361 for 
more on creating hot spots. 


+ You cannot animate attributes in <regPoint> or <transition> tags. 


Animating Clip Attributes 


The following table lists all the attributes that you can animate in clip source 
tags. That is, you can use any of the following as values for attributeName when 
targetElement identifies a tag such as <video/>, <img/>, or <ref/>. 


Clip Attribute Values You Can Animate 


Attribute Effect Reference 


backgroundColor | Modifies the background color of the region playing | page 294 
the clip. You could change the color from red to blue 
midway through a presentation, for example. 


rn:background Modifies the opacity in a clip’s background page 223 
Opacity transparency. You could make the clip more opaque, 
for example. 


bottom Changes the clip’s bottom offset from its playback page 294 
region. Animating this attribute can make the clip 
taller or shorter, as well as move it vertically. 


color Changes the color of a <brush/> object. page 213 


height Modifies the clip’s height. You can animate this page 294 
attribute along with width to change a clip’s size. 


left Changes the clip’s left offset. Animating this page 294 
attribute can make the clip narrower or wider, as well 
as move it horizontally. 


rn:mediaOpacity | Turns opaque areas in the clip transparent. By page 223 
animating this attribute, you can make the clip blend 
in with the region background color. 


right Changes the clip’s right offset. Animating this page 294 
attribute can make the clip narrower or wider, as well 
as move it horizontally. 


top Changes the clip’s top offset. Animating this page 294 
attribute can make the clip taller or shorter, as well as 
move it vertically. 


(Table Page 1 of 2) 
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Clip Attribute Values You Can Animate (continued) 


Attribute Effect Reference 


width Alters the clip’s width. You can animate this attribute | page 294 
along with height to change a clip’s size. 


z-index Changes the clip’s stacking order. You can animate page 294 
this attribute to bring one clip in front of another. 


(Table Page 2 of 2) 


Tips for Animating Clip Source Tags 


- An attribute does not have to be explicitly declared. You can animate a 
width attribute, for example, even if it is not explicitly defined in a clip 
source tag 


- Animating a size or position attribute (such as width or top) in a clip 
creates or modifies a single-use subregion that holds the clip. Therefore, 
the points about animated regions described in “Tips for Animating 
Regions” on page 424 apply to these types of clip animations. 


For More Information: The section “Defining Single-Use 
Subregions” on page 294 explains these types of subregions. 


- An animated clip cannot display outside of its playback region. To move a 
clip anywhere within the <root-layout/> or <topLayout> area, animate the 
main region that contains the clip, rather than the clip itself. 


Animating Hot Spot Attributes 


An animation tag can select the coords attribute of an <area/> tag to change 
the shape of a hot spot hypertext link. For information on the <area/> tag and 
the coords attribute, see “Using the <area/> Tag” on page 360. 


Defining Simple Animation Values 


Three animation attributes, to, by, and from, provide a simple means of 
defining where an animation starts and stops. Use either the to or the by 
attribute, but not both, to determine the animation end point. With either of 
these attributes, you can use the optional from attribute to change the 
animation’s starting point. 


Animating an Attribute to a Certain Point 


The to attribute defines the animation’s end point. It takes a value of the type 
appropriate for the animated attribute. When animating a layout attribute, 
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for example, use a pixel or percentage value, either positive or negative. When 
animating a color, use a color name or value. For example, suppose that you 
have defined this region: 


<region id=“video_region” width="320" height=“240" backgroundColor="green”/> 


You could change the background color to yellow over the course of five 
seconds with an animation tag like the following: 


<animate targetElement="video_region” attributeName="backgroundColor” to="red” 
dur="5s"/> 


Using the to attribute, you could also animate the region’s size or placement. 
When it becomes active, the following <animate/> tag expands the region’s 
width to 380 pixels over the course of three seconds: 


<animate targetElement="video_region” attributeName="width” to="380" dur="3s" /> 


If you do not include a from attribute, the animation starts at the value 
specified in the target element tag. In the preceding example, the animation 
starts at the region’s normal width of 320 pixels. If you specify a from value, 
though, the region expands or contracts to that size instantly when the 
animation becomes active. With the following animation, the region first 
contracts to half its defined size, then grows to 380 pixels over five seconds: 


<animate targetElement="video_region” attributeName="width” from="160” 
to="380" dur="5s"/> 


Animating an Attribute by a Certain Value 


The by attribute defines a certain value by which the animation progresses. 
Use it to animate sizes or positions, but not colors. The by attribute can take a 
pixel or a percentage value, either positive or negative. Suppose that you want 
to expand the width of the following region: 


<region id=“video_region” width="320" height=“240"/> 


When it becomes active, the following <animate/> tag expands the region’s 
width by 30 pixels to a final width of 350 pixels: 

<animate targetElement="video_region” attributeName="width” by="30" dur="3s"/> 
Because no from value is specified, the animation starts with the region’s 


defined width. If you specified a different from value, the region would expand 
or contract to that size instantly when the animation became active. 
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Tips for Defining Simple Animation Values 


+ By default, an animation flows smoothly over the course of its duration. 
But you can use calcMode=“discrete” to make the animation jump from its 
starting point to its stopping point. See “Controlling How an Animation 
Flows” on page 429 for more information. 


+ When animating a layout attribute, you can use a pixel value for the to or 
by attribute even if the region or subregion is defined with percentages, 
and vice versa. 


- You can use negative pixel or percentage values when animating a size or a 
position. For example, animating a region width with by="-25%”" shrinks 
the region to three-quarters of its normal size. Specifying by="-40" for a 
region’s left attribute moves the region 40 pixels to the left, whereas using 
by="40" moves the region 40 pixels to the right. 


Not all negative values are useful. For example, using a negative value with 
the to attribute when animating a size (such as to="-25%" or to="-44” when 
animating a region width) causes the element to disappear completely. 


Defining a Range of Animation Values 


Using a values list, you can animate an attribute through multiple values. This 
lets you define animations that are more complex than those possible with the 
to, by, and from attributes. In the following example, a values attribute 
animates a region’s width to four different sizes over 15 seconds: 


<animate targetElement="video_region” attributeName="width” dur="15s” 
values="58;150;96;110"/> 
Tips for Defining a Values List 
+ Enclose the entire values list in double quotation marks. 


+ You can include spaces before or after a semicolon that separates values, 
but spaces are not necessary. 


- You do not need to add a semicolon after the last value. 


- As with the to and by attributes, you can specify negative pixel or 
percentage values when animating sizes and placements. 


+ The animation always proceeds in order from the first value to the last 
value. The first value is applied when the animation activates. The 
animation reaches the last value by the end of its duration. 
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- In avalues list, use values appropriate to the animated attribute. When 
animating a region, for example, use percentages, pixels, or a mix of both: 


values="25%;50%;380” 


- You can use a values list to animate colors. List either color names or color 
codes, as in values=“blue;green;#3FD233;rgb(255,12,192)”. 


+ A list with only two values is equivalent to using the from and to attributes. 
For example, values="58;150" functions the same as from="58" and 
to="150". 


Controlling How an Animation Flows 


The calcMode attribute, which works with the values, to, and by attributes, 
controls how the animation flows from point to point. It has three possible 
values, as described in the following table. 


calcMode Attribute Values 


Value Function Reference 
discrete | Makes the animated element jump from value to value. page 429 
linear Causes the animated element to flow smoothly from value to | page 430 


value, with the movement from each value taking an equal 
amount of time. This is the default value for <animate/> and 
<animateColor/>. 


paced Makes the animated element flow smoothly from value to page 430 
value, with the movement evenly paced throughout the entire 
animation. With to and by, this functions the same as linear. 
This is the default value for <animateMotion/>. 


Jumping from Value to Value 


The discrete value for calcMode causes the animation to jump from point to 
point in the values list. For example, the following tag animates a region’s 
width to four values over the course of eight seconds: 


<animate targetElement="video_region” attributeName="width” dur="8s” 
values="50;75;150;100" calcMode="discrete” /> 


When the animation begins, the region’s width is set to 50 pixels. At two 

seconds, the width jumps up to 75 pixels. At four seconds, it jumps up to 150 
pixels. And at six seconds, it jumps down to 100 pixels, staying at that size for 
the remaining two seconds of the duration. Note that the last value is reached 


429 


RealNetworks Production Guide 


430 


at six seconds, rather than at the end of the eight-second duration. This makes 
each value active for an equal stretch (2 seconds) of the 8-second duration. 


The calcMode=“discrete” value also works with the to and by attributes to make 
the animation jump to its ending point. In the following example, the region 
width stays at 160 pixels through the first three seconds of the animation, 
then jumps to 320 pixels for the last three seconds: 


<animate targetElement="video_region” attributeName="width” from="160” 
to="320" calcMode="discrete” dur="6s"/ 


Moving Linearly from Point to Point 


The following animation uses the default value calcMode=“Linear” to animate a 
region’s width between four points over the course of 9 seconds: 


<animate targetElement="video_region” attributeName="width” dur="9s” 
values="50;75;200;100" calcMode="linear”/> 


When the animation begins, the region’s width is set to 50 pixels. It then 
begins to expand, reaching 75 pixels at three seconds. By six seconds, the 
width has grown to 200 pixels. It then begins to contract, reaching 100 pixels 
at nine seconds. So in contrast to the calcMode="discrete” example in the 
preceding section, the last value in this calcMode="linear” example is reached at 
the very end of the animation duration. 


The speed of each segment in this animation increases with the distance 
between points. Notice that the distance from the first to the second point is 
25 pixels, whereas the distance from the second to the third point is 125 
pixels. Because each point-to-point expansion or contraction takes an equal 
amount of time, the speed of movement from the first to the second point is 
slower than the speed of movement from the second to the third point. 


Flowing at an Even Pace 


If you use calcMode="paced”, movement flows smoothly over the course of the 
entire animation. When the following animation starts, the region width is 50 
pixels. The region then expands at an even pace to 150 pixels before 
contracting at the same pace to 100 pixels: 


<animate targetElement="video_region” attributeName="width” dur="6s” 
values="50;150;100" calcMode="paced” /> 


Because the animation is paced, the distance between points in the values list 
affects how long each phase takes. The distance of the expansion phase is 100 
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pixels (150 - 50), whereas the distance of the contraction phase is 50 pixels 
(150 - 100). The expansion therefore takes twice as long as the contraction. 
Because the animation lasts 6 seconds, the expansion takes 4 seconds, while 
the contraction takes 2 seconds. 


Note that when you use calcMode=“paced”, using more than two values has no 
effect if all values make the animation flow in the same direction. For 
example, consider the following attributes: 


values="50;75;90;100;125;150" calcMode="paced” 


Each value in the list above is greater than the preceding value. The animation 
therefore flows continuously in a positive direction. With the paced mode, 
though, only the first and last values will affect the speed. (This is not true 
with the linear value, however.) Hence, the preceding example functions the 
same as the following: 


values="50;150" calcMode="linear” 


Tip: When using only two values, use calcMode="linear”, which 
is slightly more efficient with computer CPU than 
calcMode=“paced”. 


Multiple values affect a paced animation only when they reverse the 
animation’s direction. In the following example, the animation flows 
positively from the first to the second point, negatively from the second to the 
third point, and so on. Each value therefore affects the animation’s 
appearance: 


values="50;90;75;125;100;150" calcMode="paced” 


Creating Additive and Cumulative Animations 


As summarized in the following table, the accumulate and additive attributes 
let you create animations that build through repeating cycles. 


Additive and Cumulative Attributes 
Attribute Value Function Reference 


accumulate none|sum Makes a repeating animation build | page 432 
with each iteration. 


additive replace|sum Adds the animation value to the page 432 
existing value. 
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Adding Animation Values to a Base Value 


Using additive animation, you can animate target attributes by increments, 
rather than by absolute values. You can use additive animations for sizes and 
placements, but not colors. Although additive animations are useful on their 
own, they are more powerful when combined with cumulative animations, 
which the next section describes. To illustrate additive animation, consider the 
following region: 

<region id=“video_region” width="320" height=“240"/> 


Suppose that you want to add 60 pixels to the width of this region in three 
steps, each step adding 20 pixels to the width. As described in the preceding 
sections, you can do this by specifying the exact width values in a values list: 


<animate targetElement="video_region” attributeName="width” dur="3s” 
values="340;360;380" calcMode="discrete” /> 


Or, you could use additive="sum” to tell RealOne Player to treat each specified 
value as an increment to add to the original width value: 


<animate targetElement="video_region” attributeName="width” dur="3s” 
values="20;40;60" additive="sum” calcMode="discrete”/> 


The preceding example tells RealOne Player to add 20 pixels to the region’s 
original width, then add 40 pixels to the original width, then add 60 pixels to 
the original width. Note that each list value is added to the target region’s 
original width, not to the animated width created by the preceding list value. 


Additive animation also works with the from and to values, but it provides 
little benefit. For example, you could add 20 pixels to a region width with 
these attributes: 


from="0" to="20" additive="sum” 
But it’s simpler in this case to use just the by attribute: 


by="20" 


Making Animations Repeat and Grow 


A cumulative animation uses a repeatCount or repeatDur attribute to repeat the 
animation. It also uses accumulate=“sum” to increase or decrease the animated 
value with each iteration. You can use cumulative animations for sizes and 
placements, but not colors. To demonstrate cumulative animation, consider 
the following region: 


<region id=“image_region” width="180”" height="180"/> 
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A simple cumulative animation could use the by attribute to increase the 
region width on each iteration of an animation. The following animation 
repeats four times. On each iteration, the region’s width increases by 16 pixels: 


<animate targetElement="image_region” attributeName="width” dur="2s” 
by="16" accumulate="sum” repeatCount="4" calcMode="discrete” /> 


The by attribute always adds a certain amount to the target value, making it 
naturally additive. When using a values list with a cumulative animation, 
though, you need to include additive=“sum” as described in “Adding Animation 
Values to a Base Value” on page 432. Consider the following example: 
<animate targetElement="image_region” attributeName="width” dur="2s” 


values="5;20" additive="sum” accumulate="sum” repeatCount="2” 
calcMode="discrete” fill="freeze”/> 


In this example, each repetition lasts two seconds, the calcMode value is 
discrete, and there are two values (5 and 20) in the values list. These attributes 
cause the animation to behave as follows: 


+ When the animation starts, the region width instantly grows by 5 pixels. 
Because the region was defined to have a 180 pixel width, its new width is 
185 pixels. 


+ One second after the animation starts, the region width grows to 200 
pixels, 20 pixels more than its original width. Note that the 20 pixels are 
added to the original width, not to the preceding animated width. At this 
point, therefore, the region is 15 pixels wider than it was one second 
earlier. 


- At two seconds, the animation repeats. Because the animation is 
cumulative, the region does not reset to its original width. Instead, it 
grows by an additional 5 pixels to a width of 205 pixels. 


- At three seconds, the region grows 20 pixels wider than its width at the 
start of the second repetition. It therefore ends at a final width of 220 
pixels. 
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The following sections describe the specialized animation tags, which are 
variations of the <animate/> tag. You should understand how the <animate/> 
tag works before using the specialized tags summarized in the following table. 


Specialized Animation Tags 
Tag Function Reference 


<animateColor/> | Changes a color value for a region or clip. page 434 


<animateMotion/> | Moves an element both horizontally and vertically. | page 435 


Sets an attribute to a new value instantly. 


For More Information: For information about the <animate/> tag 
and the various attributes you can use in the specialized 
animation tags, see “Creating Basic Animations” on page 421. 


Animating Colors 


The <animateColor/> tag works like an <animate/> tag, but is limited to color 
animations only. Although you can perform any color animation with an 
<animate/> tag, you may find it useful to use <animateColor/> to distinguish 
color animations from other animations. The following table lists the clip and 
region color properties you can animate. In other words, you can use the 
following attributes as values for attributeName in an <animateColor/> tag. 


attributeName Values Used in the <animateColor/> Tag 


Attribute Target Effect Reference 
backgroundColor clip. Modifies a root-layout, secondary _| page 290 
region, | wndow, or region background 


window | color. 


color clip Changes a <brush/> object color. page 213 


The following example changes a region’s background color to red: 
<animateColor targetElement="image_region" attributeName="backgroundColor" 
to="red" begin="1s" dur="12s" fill="freeze"/> 

You can also animate an element through several colors with a values list, as 
shown in the following example: 


<animateColor targetElement="image_region" attributeName="backgroundColor" 
values="red;blue;yellow" calcMode="discrete” .../> 
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When you use calcMode=“discrete”, only the specified colors display. If you use 
paced or linear as the calcMode value, though, intermediate colors display. The 
paced and linear modes create subtle differences when used with colors. 
Suppose you specify the following values: 


values="#FFDD11;#FFDD22;#FFDDFF” 


With the paced mode, the animation flows smoothly from #FFDD11 to #FFDDFF. 
With the linear mode, though, the first half of the animation flows from 
#FFDD11 to #FFDD22. The second half of the animation flows from #FFDD22 to 
#FFDDFF. Because the first half covers fewer color values, the color changes 
appear to occur more slowly than in the second half. 


For More Information: For more on calcMode, see “Controlling 
How an Animation Flows” on page 429. Appendix C describes 
SMIL color values. 


Tip: Color animations are not additive or cumulative, so do not 
use the by, additive, or accumulate attribute when animating a 
color with <animateColor/> or <animate/>. 


Creating Horizontal and Vertical Motion 


An <animateMotion/> tag moves an element both horizontally and vertically. 
Although you can move an element both horizontally and vertically by using 
two <animate/> tags, it’s often simpler to use a single <animateMotion/> tag, 
which has the following features and restrictions that differentiate it from the 
<animate/> tag: 


+ The <animateMotion/> tag does not use an attributeName attribute. The tag 
always selects the upper-left corner of the element defined with the 
targetElement attribute. 


+ The <animateMotion/> tag can use a values list, or the to, by, and from 
attributes. You must always specify value pairs, the two values separated 
by a comma. The first value in the pair is the horizontal coordinate (x- 
coordinate), and the second value is the vertical coordinate (y-coordinate). 
The following are sample values: 

* to="120,180" 
2 by="7 5%,15%” 
+ values="60,120;80,150" 


435 


RealNetworks Production Guide 


436 


+ The default value for calcMode is paced, rather than linear. This produces a 
smoother flow of motion when you animate an element through several 
points. For more on calcMode, see “Controlling How an Animation Flows” 
on page 429. 


- Although you can use <animateMotion/> to move a clip either horizontally 
or vertically, the <animate/> tag uses less CPU power on the RealOne Player 
computer to create this movement. It’s recommended, therefore, to use 
<animateMotion/> only for diagonal movement. 


The following example moves the upper-left corner of the targeted region to 
the three points defined in the values list. Because calcMode=“discrete” is used, 
the region will jump from point to point rather than flow smoothly: 


<animateMotion targetElement="image_region" values="180,180;60,340;125,95" 
calcMode="discrete" begin="7s" dur="5s" fill="freeze"/> 


Setting an Attribute Value 


The <set/> tag changes an attribute to a specific value until the tag is no 
longer active. It is useful, for example, to change a region background color 
while a clip plays. You can use this tag with any attribute that you can animate 
with the <animate/> tag. The <set/> tag can therefore change element sizes, 
positions, and colors. It uses fewer animation attributes than <animate/>, as 
summarized in the following table. 


<set/> Tag Attributes 
Attribute Value Function Reference 
attributeName | attribute_name Selects the attribute to animate. page 422 
targetElement | ID Identifies the tag that contains the | page 422 


animated attribute. 


to pixels |percentage| | Sets the new attribute value. page 426 
color_value 


A <set/> tag can use the basic SMIL timing attributes of begin, dur, and fill. The 
following example shows a <set/> tag changing a region background color. 


The region color changes instantly when the animation becomes active, then 
resets to its previous value after 30 seconds: 


<set targetElement="video_region” attributeName="backgroundColor” to="blue” 
dur="30s”"/> 
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If the <set/> tag does not define a duration explicitly, the animation lasts as 
long as the <set/> tag is active. If the <set/> tag is associated with a clip tag, for 
instance, the animation lasts until the clip’s duration expires. In the following 
example, the animation expires when the image’s 10-second duration elapses, 
even though the image still appears onscreen because of its fill="freeze” value: 
<img src="imagel.gif” region="image_region” dur="10s” fill="freeze”/> 

<set targetElement="video_region” attributeName="backgroundColor” to="blue”/> 
</img> 


Tip: To disassociate the <set/> tag from the clip’s timing 
attributes, place the <set/> tag and the clip source tag ina 
parallel group, as described in “Animation Tag Placement” on 
page 418. 


Manipulating Animation Timing 


RealOne Player supports SMIL time manipulations for animations (and only 
animations). Time manipulations can control the rate of an animation to 
make it appear to accelerate or decelerate, for example. A later version of this 
guide will explain how to create time manipulations. Currently, you can learn 
about time manipulations in the SMIL 2.0 specification: 


http://www.w3.org/TR/smil20/smil-timemanip.html 
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SWITCHING 


SMIL switching gives you a powerful way to provide different clips 
that RealOne Player chooses between based on certain criteria. For 
example, you can have each RealOne Player select an audio track 
based on each viewer’s language preference. This chapter explains 
how to set up switch groups to stream different clips to different 


audiences. 


Understanding Switching 


SMIL switching is a powerful means to tailor presentations for different 
audiences without making viewers choose which presentation they wish to 
view. In cases such as language choice, SMIL switching occurs automatically 
based on a preference the viewer has set in RealOne Player. In other cases, such 
as available bandwidth or monitor size, switching is based on an attribute that 
the viewer does not control. In all cases, however, RealOne Player 
automatically makes the choice without input from the viewer. 


Tip: When you want viewers to choose options themselves, use 
an <excl> tag, not a <switch> tag. For more on the <excl> tag, see 
“Creating an Exclusive Group” on page 259. 


Note: The following sections demonstrate switching with clips 
recorded in different languages. Keep in mind, though, that 
the same principles apply to switching through other criteria, 
such as bandwidth or monitor size. 


Creating a Switch Group 


A switch group starts with a <switch> tag and ends with a </switch> tag. 
Between these tags, you list multiple options, such as multiple clip source 
tags, that each contain a test attribute. RealOne Player evaluates the options 
in the order you list them, choosing the first option that it can play. For 
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example, in the following simple <switch> group, the systemLanguage test 
attributes cause RealOne Player to choose one of two audio clips based on its 
language preference: 
<switch> 

<audio src="french.rm” systemLanguage=" fr” /> 

<audio src="german.rm” systemLanguage="de” /> 
</switch> 


Only RealOne Players in which the viewer has selected French (fr) as the 
language preference will choose the first clip. Only RealOne Players in which 
the viewer has selected German (de) as the language preference will choose the 
second clip. A RealOne Player with another language preference will not play 
either clip: it simply ignores the clips in the <switch> group and proceeds to 
the next part of the presentation. Hence, a RealOne Player either plays just one 
clip from a <switch> group, or it plays no clip. But it never plays more than one 
option. 


Adding a Default Option to a Switch Group 


To reach the widest audience of viewers, a <switch> group needs to have a 
default option. Without this option, certain RealOne Players may not play any 
clips in the group. A default option must satisfy these criteria: 


+ The default option must not include a test attribute. 


Any RealOne Player will choose an option that does not include a test 
attribute. Hence, any RealOne Player that did not choose an option with a 
test attribute will choose the option without the test attribute. 


+ The default option must be the last option in the <switch> group. 


RealOne Player always evaluates options in the order they are listed, 
playing the first suitable option it finds. If you list a default option before 
options that include test attributes, no RealOne Player will ever evaluate 
the test attributes of the options following the default option. 


The following example modifies the preceding example to add an English- 
language clip as the default choice: 


<switch> 
<audio src="french.rm” systemLanguage="fr"/> 
<audio src="german.rm” systemLanguage="de"/> 
<audio src="english.rm”/> 

</switch> 
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Note that the English-language clip is listed last and does not include a 
systemLanguage test attribute, making it the default. In this example, any 
RealOne Player with a preference set to a language other than French or 
German will choose the English clip. For example, all RealOne Players with a 
language preference for Swedish, Korean, English, and so on choose the 


English-language clip. 


Using Inline Switching 


It is not always necessary to use a <switch> tag for switching. You can also use 
inline switching, which adds test attributes to clip source tags in a <par> or 
<seq> group. When RealOne Player encounters a test attribute, it evaluates the 
attribute to determine if it should play or skip the clip. In the following 
example of a parallel group, RealOne Player always plays the Flash clip, and 
then chooses the French or German audio clip based on its language 
preference: 
<par> 

<ref src="cartoon.swf” region="playback”/> 

<audio src="french.rm” systemLanguage=" fr” /> 

<audio src="german.rm” systemLanguage="de” /> 
</par> 


Choosing Inline Switching or a Switch Group 


Although useful in many situations, inline switching cannot provide a default 
option, making it less powerful than a <switch> group. Consider the following 
example, which attempts to add a default English-language clip to the 
preceding example: 
<par> 

<!-- This is NOT a good example of switching. --> 

<ref src="cartoon.swf” region="playback”/> 

<audio src="french.rm” systemLanguage="fr"/> 

<audio src="german.rm” systemLanguage="de” /> 

<audio src="english.rm”/> 
</par> 


The parallel group shown above will work for every RealOne Player, except 
those with a French or German language preference! For instance, a RealOne 
Player with a language preference for French plays the Flash (.swf) clip, the 
French RealAudio clip, and the English-language clip, which has no 
systemLanguage attribute that ties it to a language preference. Hence, the 
viewer hears an incomprehensible blend of French and English. 
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Only a <switch> tag causes RealOne Player to evaluate all options as a group 
and choose only one option. The following example illustrates the correct way 
to add the default, English-language choice to the parallel group shown above: 


<par> 
<!-- This is a good example of switching. --> 
<ref src="cartoon.swf” region="playback”/> 
<switch> 
<audio src="french.rm” systemLanguage="fr"/> 
<audio src="german.rm” systemLanguage="de"/> 
<audio src="english.rm”/> 
</switch> 
</par> 


Available Test Attributes 


The following table lists the test attributes available for switching. These 
attributes are described in detail in the remainder of this chapter. 


Switch Attributes 
Attribute Value Tests For Reference 
systemAudioDesc onloff descriptions preference page 448 
systemBitrate bits_per_second | total available bandwidth page 446 
systemCaptions on|off captions preference page 448 
systemComponent component component or version page 453 
systemCPU CPU_type computer CPU type page 449 
systemLanguage language_code | language preference page 443 
systemOperatingSystem |0S_name computer operating system | page 450 
systemOverdubOrSubtitle | overdub| overdubbing or subtitle page 445 
subtitle preference 
systemRequired prefix namespace support page 453 
systemScreenDepth 1|4]8|24|32 monitor color bit depth page 452 
systemScreenSize heightXwidth monitor size page 452 


Tips for Writing Switch Groups 


- The <switch> tag must fall within the <head> or <body> section of your 
SMIL file. In other words, the <smil>, <head>, or <body> tags cannot fall 
within a <switch> tag. 
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+ You can use a <switch> tag in the header section to let RealOne Player 
choose between alternative layouts. See “Example 3: Media Playback Pane 
Resized for Captions” on page 462 for an example of modifying the layout 
to accommodate system captions. 


You can use a <switch> tag to switch between alternative <seq>, <par>, or 
<excl> groups. In these cases, you add the test attributes to the group tags 
instead of to the clip source tags. 


You can use more than one test attribute in a tag. For example, you might 
test for monitor size and color depth at the same time. When there are 
multiple test attributes, RealOne Player must satisfy all the attribute 
values before it chooses the clip. Alternatively, you can nest <switch> tags 
to achieve the same results. See “Multiple Test Attributes” on page 456 for 
examples of how to use both methods. 


In most cases, you'll want to create a default value so that every RealOne 
Player will find an option that it can play. In some cases, though, you may 
not want a default. If you’re creating a group that switches between clips 
streaming at 300 Kbps, 200 Kbps, and 100 Kbps, for example, you may 
not want to include a default choice. That way, RealOne Players connected 
through dialup modems don’t request any of the clips. 


In cases where you do not want certain RealOne Players to choose an 
option, you do not necessarily have to leave the default option out. 
Instead, you can use the default option to display a graphic or RealText 
clip informing viewers of the reason their RealOne Players cannot play the 
presentation. 


To switch between clips that use SMIL hyperlinks, create the links with 
<area/> tags inside the clip source tags, rather than with <a> and </a> tags 
around the clip tags. Add the test attribute to the clip tag, as shown here: 
<video src="videol.rm” systemLanguage="fr” ...> 


<area href="http://www.example.com” .../> 
</video> 


For More Information: For more on the <area/> tag, see “Using 
the <area/> Tag” on page 360. 


Switching Between Language Choices 


When source clips are in different languages, use a test attribute of 
systemLanguage in the clip source tag or group tag. The following example 


443 


RealNetworks Production Guide 


444 


shows a video slideshow with separate audio narrations in French, German, 
Spanish, Japanese, Korean, and English. Each RealOne Player requests the 
same slideshow, but chooses an audio clip based on its language preference 
(Tools>Preferences>Content) and its evaluation of the systemLanguage values: 
<par> 
<ref src="seattle_slides.rp”/> 
<!-- select audio based on RealOne Player language preference setting --> 
<switch> 
<audio src="seattle_french.rm” systemLanguage=" fr” /> 
<audio src="seattle_german.rm” systemLanguage="de"/> 
<audio src="seattle_spanish.rm” systemLanguage="es"/> 
<audio src="seattle_japanese.rm” systemLanguage="ja” /> 
<audio src="seattle_korean.rm” systemLanguage="ko"/> 
<audio src="seattle_english.rm”/> 
</switch> 
</par> 


The last audio option in the preceding example is the default. Because the last 
option does not have a test attribute, a RealOne Player that does not have 
French, German, Spanish, Portuguese, Japanese, or Korean set as its preferred 
language chooses the English clip. 


For More Information: See the examples in “Subtitles and HTML 
Pages in Different Languages” on page 458 for more 
demonstrations of how to use systemLanguage. 


Setting Language Codes 


Appendix I lists the codes used as systemLanguage values. In some cases, a 
primary language code has variation codes. For instance, es is the primary 
code for Spanish, corresponding to Spanish as spoken in Spain. This code has 
several variations, such as es-mx for Mexican Spanish and es-pr for Puerto 
Rican Spanish. When variation codes are used, RealOne Player uses the 
following rules to select a clip: 


- A RealOne Player with a preference for a language variation will choose 
either the variation code or the primary code, whichever comes first in the 
<switch/> group. For example, a RealOne Player with a preference for 
Mexican Spanish plays clips designated with es-mx or es. If a clip with the 
value es comes first, RealOne Player does not continue to evaluate options 
to determine if the es-mx option is present. 
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- A RealOne Player with a preference for a primary language code will not 
choose clips that use variation codes. For example, a RealOne Player with 
a preference for Spanish as spoken in Spain chooses only clips designated 
with es. If the only choices are es-mx and es-pr, for instance, this RealOne 
Player does not choose either option. 


If you have different clips for different language variations, list the clip that 
corresponds to the primary code as the last option, as shown here: 
<switch> 
<audio src="mexico.rm” systemLanguage="es-mx” /> 
<audio src="puertorico.rm” systemLanguage="es-pr”/> 
<audio src="defaultspanish.rm” systemLanguage="es”/> 
</switch> 


In the preceding example, RealOne Players with a preference for Mexican 
Spanish (es-mx) choose the first clip. RealOne Players with a preference for 
Puerto Rican Spanish (es-pr) choose the second clip. All other RealOne Players 
with a preference for any variation of Spanish choose the last clip. For 
instance, a RealOne Player with a preference for Chilean Spanish chooses the 
es option because its preferred variation (es-cl) is not listed. 


Providing Subtitles or Overdubbing 


For clips in foreign languages, RealOne Player viewers can set a preference for 
subtitles or overdubbing. The systemOverdubOrSubtitle attribute tests for this 
preference, displaying clips based on the viewer’s choice. It can have one of two 
values, either overdub or subtitle. Suppose that you have three versions of a 
RealVideo clip: 


1. an original French version (original.rm) 
2. aversion dubbed in English (dubbed.rm) 


3. the original French version with English subtitles (titled.rm) 
You can use systemOverdubOrSubtitle along with systemLanguage in a <switch> 
group as shown in the following example: 
<switch> 

<!-- Version for RealOne Players with a preference for English and overdubbing. --> 


<video src="dubbed.rm” systemLanguage="en” systemOverdubOrSubtitle=“overdub”/> 
<!-- Version for RealOne Players with a preference for English and subtitling. --> 
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<video src="titled.rm” systemLanguage="en” systemOverdubOrSubtitle=“subtitle”/> 
<!-- Version for RealOne Players with a language preference other than English. --> 
<video src="original.rm”/> 

</switch> 


In the preceding example, RealOne Players with a preference for English and 
overdubbing play the first clip. Any other RealOne Player preferring English 
plays the second clip. The original French clip is listed last with no 
systemLanguage attribute. This makes it the default played by RealOne Players 
that prefer French or another language besides English. 


Note: In the preceding example, the second clip does not need 
to specify subtitle explicitly. The systemOverdubOrSubtitle 
attribute uses only overdub or subtitle as its value. Because the 
first clip takes the overdub value, only the subtitle value is left 
for the second clip. 


Switching Between Bandwidth Choices 
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To stream different clips to viewers at different connection speeds, use the 
systemBitrate test attribute to define options each RealOne Player can choose 
based on the total amount of bandwidth it has available. The systemBitrate 
attribute takes as a value the approximate bits per second required to stream 
the whole presentation. The following sample <switch> tag lists two different 
RealPix presentations. The first is for connections that have at least 80 Kbps of 
bandwidth. The second is for slower connections, down to 28.8 Kbps modems: 
<switch> 

<ref src="slides1.rp” systemBitrate="80000"/> 


<ref src="slides2.rp” systemBitrate="20000"/> 
</switch> 


As shown above, list the bandwidth choices from fastest to slowest. RealOne 
Player evaluates options in order, selecting the first option it can play. If the 
20,000 bps option were first, a RealOne Player with a high-speed connection 
would choose it because it is the first viable option. Also ensure that the last 
option satisfies the slowest connection speed you want to support. If the last 
choice is systemBitrate="60000", for example, RealOne Players on modems will 
not play the presentation because its bandwidth requirement is too high. 


The more complex example below shows three sets of clips. Each <par> tag has 
a systemBitrate attribute that lists the approximate bandwidth the clips as a 


CHAPTER 18: Switching 


whole consume. Note that each group uses the same RealText clip, but has 
different RealAudio and RealPix clips created for its bandwidth: 


<switch> 

<par systemBitrate=”"225000"> 
<!--RealOne Players with 225 Kbps or faster connections choose this group--> 
<audio src="music1.rm”/> 
<ref src="slides1.rp” region="images”/> 
<textstream src="narration.rt” region="text”/> 

</par> 

<par systemBitrate="80000"> 
<!--RealOne Players with connections between 80 and 225 Kbps get this group--> 
<audio src="music2.rm"/> 
<ref src="slides2.rp” region="images”/> 
<textstream src="narration.rt” region="text”/> 

</par> 

<par systemBitrate=”"20000"> 
<!--RealOne Players with connections between 20 and 80 Kbps get this group--> 
<audio src="music3.rm"/> 
<ref src="slides3.rp” region="images” /> 
<textstream src="narration.rt” region="text”/> 


</par> 
</switch> 


For More Information: The table “Maximum Streaming Rates” 
on page 47 gives bandwidth guidelines for various network 
connections. 


Switching with SureStream Clips 


With RealAudio or RealVideo clips encoded for multiple bit rates with 
SureStream technology, you may or may not need to use the <switch> tag with 
a systemBitrate attribute. The following guidelines will help you to make this 
decision: 

+ When the presentation consists solely of a SureStream clip, simply link to 
that clip within the SMIL file. The clip then streams at the rate 
appropriate for RealOne Player’s connection speed. You do not need to 
specify bandwidth choices with a <switch> tag. 


- Use the <switch> tag when combining a SureStream clip with other clips 
encoded for single bandwidths. The SureStream clip is always used, but 
the <switch> group gives RealOne Player options for other clips. The 
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following example illustrates a RealAudio SureStream clip and a choice 
between two RealPix presentations built for different bandwidths: 
<par> 
<audio src="soundtrack.rm”/> 
<switch> 
<ref src="slideshow1.rp” systemBitrate="47000” region="images”/> 
<ref src="slideshow2.rp” systemBitrate="20000” region="images”/> 
</switch> 
</par> 
RealOne Players that have at least 47,000 bits per second of available 
bandwidth choose slideshow1.rp. If this slideshow takes 25 Kbps, for 
example, these RealOne Players pick a SureStream track from 
soundtrack.rm that requires 22 Kbps or less of bandwidth. RealOne Players 
with between 47,000 and 20,000 bps of available bandwidth choose 
slideshow2.rp, along with a SureStream track that keeps the combined 
clips under 20 Kbps. 


For More Information: For more on SureStream, see 
“SureStream RealAudio and RealVideo” on page 50. Refer to 
“Step 4: Develop a Bandwidth Strategy” on page 45 for 
information on targeting certain network connection speeds. 


Enhancing Presentation Accessibility 


RealOne Player users who are sight- or hearing-impaired can set accessibility 
preferences (Contents under Tools>Preferences) that give them audio 
descriptions or captions when those options are available. You can match 
RealOne Player viewers to these options with the systemAudioDesc and 
systemCaptions attributes. Both attributes, which you can use together or 
singly, take a value of either on or off. Suppose you have three versions of a 
video clip: 


1. An original version for viewers with no accessibility preference (video.rm). 


2. A version for sight-impaired viewers with a preference for audio 
descriptions (video_descriptions.rm). A video with audio descriptions 
might consist of a standard video that pauses intermittently while a 
separate audio track encoded in the clip describes upcoming scenes. 


3. A version for hearing-impaired viewers with a preference for captions 
(video_captions.rm). A video with captions might consist of a standard 
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video that includes encoded captions similar to subtitles, but in the same 
language as the video’s audio track. 


You can use inline switching with the systemAudioDesc and systemCaptions 
attributes as shown in the following example to choose between clips based on 
the viewer’s accessibility preference: 
<seq> 

<video src="video_descriptions.rm” systemAudioDesc="on"/> 

<video src="video_captions.rm” systemCaptions="on"/> 

<video src="video.rm”/> 
</seq> 


For More Information: See “System Captions Using RealText” on 
page 460 for an example of using RealText to provide system 
captions. 


Switching Based on the Viewer’s Computer 


Note: Switching based on computer attributes is not currently 
functional in RealOne Player. 


Several <switch> tag attributes—systemCPU, systemOperatingSystem, 
systemScreenSize, and systemScreenDepth—let you switch between clips or 
groups based on the viewer’s computer hardware or software. This lets you 


tailor a presentation’s size or clip types, for example, based on the features of 
the machine running RealOne Player. 


Switching for CPU Type 


The systemCPU attribute lets you switch clips based on the processor for the 
RealOne Player computer. This attribute identifies the computer processor 
but no other machine attributes, such as the computer’s clock speed, available 


memory, or operating system. The following table lists the possible values for 
the systemCPU attribute. 


systemCPU Attribute Values 


Attribute Value Computer Processor Selected 
alpha Compaq Alpha processor 

arm Unix-based server processor 
arm32 Unix-based server processor 


(Table Page 1 of 2) 
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systemCPU Attribute Values (continued) 


Attribute Value Computer Processor Selected 

hppal.1 Hewlett-Packard Unix-based server processor 

m68k pre-PowerPC Macintosh 

mips Unix-based server processor 

ppc PowerPC Macintosh and Linux 

rs6000 IBM Unix-based server processor 

unknown unknown processor type 

vax DEC VAX running VMS or Unix 

x86 Intel chip set for Windows and Linux PCs and servers 


(Table Page 2 of 2) 


Note: The preceding table lists all systemCPU attribute values 
defined for SMIL. This does not mean, however, that RealOne 
Player is available for each hardware platform. 


Switching for Operating System 


The systemOperatingSystem attribute lets you switch clips based on the 
operating system running on the RealOne Player computer. This attribute 
does not discriminate between various versions of an operating system, 
however. The following table lists the values for systemOperatingSystem. The 
last column indicates if a version of RealOne Player is available for that 
operating system. Note, however, that RealOne Player availability is subject to 


change. 
systemOperatingSystem Attribute Values 
RealOne 
Attribute Value Operating System Selected Player? 
aix IBM AIX version of Unix yes 
beos Be operating system no 
bsdi Berkeley Software Design’s version of Unix no 
dgux Data General UX version of Unix no 
freebsd FreeBSD version of Unix no 
hpux HP-UX version of Unix yes 
irix Silicon Graphics Irix version of Unix yes 
linux Any Linux distribution yes 


(Table Page 1 of 2) 
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systemOperatingSystem Attribute Values (continued) 


RealOne 
Attribute Value Operating System Selected Player? 
macos Any Macintosh operating system, including MacOSX | yes 
ner NCR network operating system no 
nec NEC version of Unix no 
netbsd Network BSD version of Unix no 
nextstep NeXT operating system no 
nto NTO version of Unix no 
openbsd Open BSD version of Unix no 
openvms Open VMS no 
os2 IBM OS/2 no 
osf Open Software Foundation’s version of Unix no 
palmos Palm operating system no 
qnx QNX Software System’s realtime platform no 
rhapsody Macintosh OSX Server no 
sco Caldera version of Unix (fomerly Santa Cruz no 
Operations) 

sinix Siemens Nixdorf version of Unix no 
solaris Sun Solaris version of Unix yes 
sunos Sun version of Unix pre-dating Solaris no 
unixware Caldera version of Unix (formerly Novell) yes 
unknown unknown operating system n/a 
win16 Microsoft Windows 16-bit OSes yes 
win32 Microsoft Windows 32-bit OSes yes 
win9x Microsoft Windows 95/98/ME yes 
wince Microsoft Windows CE and PocketPC yes 
winnt Microsoft Windows NT/2000/XP yes 


(Table Page 2 of 2) 


Switching for Monitor Size or Color Depth 


Two test attributes, systemScreenSize and systemScreenDepth, let you switch 
clips based on the size and color capability of the monitor displaying RealOne 
Player. They are useful if you have different versions of the same video in 
different sizes or different color depths, for example. 


451 


452 


RealNetworks Production Guide 


Specifying a Monitor Size 


The systemScreenSize attribute uses a pixel measurement value in the form 
heightXwidth. The value specifies that the monitor displaying RealOne Player 
must be of the given size or larger. The following are common systemScreenSize 
values: 


1024X1280 common size for 21-inch monitors or larger 


768X1024 common size for 17-inch monitors or larger 
600X800 common size for 15-inch monitors or larger 
480X640 smallest desktop monitor size in general use 


Note: You must use a capital “X”. Note, too, that monitor sizes 
are commonly referred to in a width-by-height format, such as 
640-by-480. With SMIL, though, you must specify height first. 


Because a monitor must be at least the specified size for RealOne Player to 
choose an option, always list options from the largest to the smallest screen 
size as shown above. If you listed systemScreenSize="480X640" first, for example, 
all RealOne Players on standard desktop computers would choose that option 
because all standard desktop monitors are at least that size. 


Tip: Keep in mind that computer users can generally set their 
monitor resolutions differently. Some 17-inch monitors may 
have a resolution of 768X1024 for example, while others are set 
to 600X800. 


Specifying a Color Depth 


The systemScreenDepth attribute uses an integer value that specifies the color 
bit depth of the monitor. The monitor must have the given bit depth or higher 
to play the clip. The following are common systemScreenDepth values: 
32 ~~ millions of colors 
24 millions of colors 
16 thousands of colors 
256 colors 
4 16 colors 
1 black-and-white 
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Because a monitor must have at least the specified color depth for RealOne 
Player to choose an option, always list options from the highest bit depth to 
the lowest as shown above. If you listed systemScreenDepth="8” first, for 
example, all RealOne Players on standard color monitors would choose that 
option because all standard color monitors can display at least 256 colors. 


Checking Components and Version Numbers 


Using the systemRequired and systemComponent attributes, you can define an 
element that plays only if RealOne Player (or another SMIL-based media 
player) is above a specific version number, or possesses a certain component, 
such as a plug-in required to render a clip. The following sections describe how 
to use these attributes within SMIL 2.0, and how to use them to provide 
backward-compatibility with SMIL 1.0. 


Defining Test Attributes in SMIL 2.0 


The following abstract example illustrates how systemRequired and 
systemComponent attributes work in SMIL 2.0: 
<smil xmlns=“http://www.w3.org/2001/SMIL20/Language” 
xmlns:prefix="customizations_namespace”> 
<body> 
<switch> 
<ref systemRequired="prefix” prefix:systemComponent="component” 
...clip to use if the player has the specified component.../> 
<ref ...clip to use if the player does not have the specified component.../> 
</switch> 
</body> 
</smil> 


The <switch> tag in this example enables RealOne Player to choose between 
two clips, the second of which is a default choice that plays if RealOne Player 
does not meet the requirements of the first clip. 


The Customizations Namespace 
The <smil> tag in the preceding example defines a customizations namespace 
that is specific to the media player being tested: 


xmlns:prefix="customizations_namespace” 


A customizations namespace is required because the systemComponent 
attribute values are different for each media player. For example, the 
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systemComponent value that tests for the version number of RealOne Player is 
different from a systemComponent value that tests for the version number of a 
different SMIL-based media player. The namespace defines the values that the 
media player can expect to encounter for systemComponent. 


For More Information: For more on namespaces, see “Using 
Customized SMIL Attributes” on page 203. 


The systemRequired Attribute 

The systemRequired attribute takes as a value the prefix for the customizations 
namespace. This is necessary because a media player that does not handle a 
certain attribute, such as a specific systemComponent value, ignores the 
attribute but still plays the element. The systemRequired attribute overrides 
this default behavior, making the media player ignore the element entirely if 
the player does not recognize the customizations namespace. 


The systemComponent Attribute 

The systemComponent attribute selects a component or property that RealOne 
Player or another media player must possess, such as a certain version number. 
The values are specific to each media player. 


Note: A later version of this manual will describe components 
and properties that you can test for in RealOne Player. 

Currently, the primary use of systemComponent is to add SMIL 
2.0 features to a SMIL 1.0 file, as explained in the next section. 


Combining SMIL 2.0 with SMIL 1.0 


The previous section describes how to use systemComponent and systemRequired 
within a SMIL 2.0 environment. This section explains how you can use 
systemComponent and system-required (the SMIL 1.0 version of systemRequired) 
to create a file that plays as SMIL 1.0 in RealPlayer 7 and RealPlayer 8 (but not 
RealPlayer G2), and contains enhanced SMIL 2.0 features for RealOne Player. 
This lets you add SMIL 2.0 features to existing SMIL 1.0 files, for instance. 


Tip: Because of the many differences between SMIL 1.0 and 
SMIL 2.0, RealNetworks does not recommend creating a 
complex SMIL file that plays as SMIL 2.0 in RealOne Player 
and as SMIL 1.0 in RealPlayer 7 and 8. Use this backward- 
compatible method only for adding a small number of SMIL 
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2.0 features to existing SMIL 1.0 presentations. Otherwise, 
create separate SMIL 1.0 and 2.0 files. 


Testing for the Player Version 


To add SMIL 2.0 functionality to a SMIL 1.0 file, you use systemComponent and 
system-required to test the player version on each SMIL 2.0 element. This 
enables RealPlayer 7 and 8 to ignore the element. The following example 
modifies the SMIL 2.0 example in the preceding section, adding the attributes 
and values that are specific to testing for the RealPlayer version number: 
<smil xmlns=“http://www.w3.org/2001/SMIL20/Language” 
xmlns:cv=“http://features.real.com/systemComponent”> 
<body> 
<switch> 
<ref system-required="cv” 
cv:systemComponent="http://features.real.com/?component;player=6.0.10" 
...clip for RealOne Player to play.../> 
<ref ...clip earlier versions of RealPlayer to play.../> 
</switch> 
</body> 
</smil> 


In this example, each player has a choice of two clips specified by <ref/> tags. 


The first <ref/> tag requires that the player be version 6.0.10 (RealOne Player) 
or higher. Earlier versions of RealPlayer choose the second, default option. 


The Customizations Namespace 

To test for the RealPlayer version number, you must include the following 
namespace. Be sure to use the cv prefix, too. In SMIL 2.0, prefixes are user- 
definable. For RealPlayer 7 and 8, however, the cv prefix is required: 
xmlns:cv=“http://features.real.com/systemComponent” 

Note that the preceding example also declares the SMIL 2.0 namespace: 
xmlns=“http://www.w3.org/2001/SMIL20/Language” 


RealPlayer 7 and 8 do not recognize the SMIL 2.0 namespace, so they ignore it 
and play the file as SMIL 1.0. Because of this namespace, though, RealOne 
Player plays the file as SMIL 2.0, letting you add SMIL 2.0 features. 


The system-required Attribute 

The system-required attribute is the SMIL 1.0 version of systemRequired. It 
ensures that the media player recognizes the customizations namespace. If the 
player doesn’t, it ignores the element entirely. 
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The systemComponent Attribute 

The systemComponent attribute in the preceding example uses the cv prefix of 
the customizations namespace, and specifies that the player must be version 
6.0.10 or higher, which is the major version number for RealOne Player. The 
syntax is specific to RealNetworks media players, and should be entered 
exactly as shown: 


cv:systemComponent="http://features.real.com/?component;player=6.0.10" 
For More Information: See “Backward-Compatible SMIL File” on 


page 463 for an example of how to add SMIL 2.0 transparency 
extensions to a SMIL 1.0 file. 


Switch Group Examples 
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The following examples illustrate different ways to use switching. Note that 
there are many applications for switching, and many ways to write SMIL 
presentations that include switching. To view more examples, get the zipped 
HTML version of this guide as described in “How to Download This Guide to 
Your Computer” on page 12, and view the Sample Files page. 


Multiple Test Attributes 


Using multiple test attributes in a <switch> group, you can have RealOne 
Player choose clips based on combined criteria, such as both available 
bandwidth and language preference. There are two ways to do this: 


+ include multiple test attributes in each tag 


* nest <switch> groups 


Example 1: Multiple Test Attributes for Each Clip 


In the following example, the first two RealAudio clips have two test attributes 
each—one for language and one for bandwidth. Both attributes must be viable 
for RealOne Player to choose the clip. Because RealOne Player evaluates the 
<switch> choices from top to bottom, selecting the first viable option, the last 
two choices do not have language attributes. This lets all RealOne Players 
other than those with French selected as their language preference choose 
between the two English-language clips, based on their available bandwidth: 
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<switch> 
<!-- French language choices --> 
<audio src="french2.rm” systemLanguage="fr” systemBitrate="47000"/> 
<audio src="french1.rm” systemLanguage="fr” systemBitrate="20000"/> 
<!-- English language choices (default) --> 
<audio src="english2.rm” systemBitrate="47000”"/> 
<audio src="englishi.rm” systemBitrate="20000”/> 

</switch> 


Example 2: Nested <switch> Groups 


The next example adds RealText clips in both French and English to the 
presentation possibilities. Here, <switch> groups are nested so that RealOne 
Players with French set as their language preference play the French RealText 
clip and choose from the set of French-language RealAudio clips, based on 
available bandwidth. All other RealOne Players play the English RealText clip 
and choose from the set of English-language RealAudio clips: 


<switch> 
<!-- Choose French as the language. --> 
<par systemLanguage="fr"> 
<textstream src="frenchcredit.rt” region="credits_region” fill="remove”/> 
<switch> 
<!-- Choose fast or slow bit rate for French audio --> 
<audio src="french2.rm” systemBitrate="47000"/> 
<audio src="french1.rm” systemBitrate=”"20000"/> 
</switch> 
</par> 
<!-- Choose English as the language. This is the default. --> 
<par> 
<textstream src="enlgishcredits.rt” region="credits_region” fill="remove” /> 
<switch> 
<!-- Choose fast or slow bit rate for English audio --> 
<audio src="english2.rm” systemBitrate="47000"/> 
<audio src="english1.rm” systemBitrate="20000"/> 
</switch> 
</par> 
</switch> 


Different Video Sizes Chosen Automatically 


As described in “Different Clip Dimensions for Different Bandwidths” on 
page 78, you can encode different sizes of the same video, streaming a small 
clip over slow modems and a larger clip (or clips) over faster connections. 
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Reducing the video size for slower connections ensures that the video’s frame 
rate and visual quality remain high. For example, you could create the three 
clips listed in the following table. 


RealVideo Clips at Different Sizes 
Clip Name Dimensions SureStream Audiences systemBitrate value 
videosmall.rm 176 x 132 28.8 and 56 Kbps Modems 20000 
videomedium.rm | 240 x 180 ISDN and corporate LANs 45000 


videobig.rm 320 x 240 256, 384, and 512 Kbps DSL_ | 225000 
and cable modems 


In the following example, each <switch> tag test attribute uses the target bit 
rate of its clip’s slowest SureStream stream. The <switch> tag then presents the 
three RealVideo choices to RealOne Player from fastest to slowest: 
<switch> 
<video src="videobig.rm” systemBitrate=”"225000” region="video_region” .../> 
<video src="videomedium.rm” systemBitrate="45000” region="video_region” .../> 
<video src="videosmall.rm” systemBitrate="20000” region="video_region” .../> 
</switch> 


For More Information: Target bit rates are listed in the table 
“Maximum Streaming Rates” on page 47. 


Subtitles and HTML Pages in Different Languages 


The section “Switching Between Language Choices” on page 443 explains the 
basics of using systemLanguage to play different clips based on viewer language 
preferences (Tools>Preferences>Content). The following examples show how to 
augment a video clip with RealText subtitles in different languages, and how 
to display different pages in the related info pane based on language choice. 


Example 1: RealText Subtitles 


The following sample SMIL file defines a small text region that overlays the 
bottom portion of a video clip. Inline switching displays RealText subtitles if 
the viewer has a language preference set to any variation of French or Spanish. 
Viewers preferring other languages see only the video: 
<smil xmlns=“http://www.w3.org/2001/SMIL20/Language” 
xmlns:rn=“http://features.real.com/2001/SMIL20/Extensions”> 

<head> 

<meta name="title" content="Semi-Transparent Video Subtitles"/> 
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<meta name="copyright" content="(c)2002 RealNetworks, Inc."/> 
<layout> 
<root-layout width="320" height="240" backgroundColor="black"/> 
<region id="video_region" z-index="1"/> 
<region id="text_region" height="35" bottom="0" left="10" z-index="2"/> 
</layout> 
</head> 
<body> 
<par> 
<video src="video3.rm" region="video_region" fill="remove"/> 
<textstream src="subtitles_fr.rt" systemLanguage="fr" region="text_region" 
rn:backgroundOpacity="45%" fill="freeze"/> 
<textstream src="subtitles_es.rt" systemLanguage="es" region="text_region" 
rn:backgroundOpacity="45%" fill="freeze"/> 
</par> 
</body> 
</smil> 


For More Information: In the preceding sample, the 
rm:backgroundOpacity attribute is used on the RealText clips to 
render their backgrounds partially transparent. For more on 
this attribute, see “Creating Transparency in a Clip’s 
Background Color” on page 223. Chapter 6 explains RealText. 


Example 2: Different HTML Pages for Different Languages 


Because SMIL lets you control HTML pages from your media, it’s easy to 
display different HTML pages in different languages based on the viewer’s 
language preference. The following sample, which omits the SMIL header, 
automatically displays one of three different HTML pages in the related info 
pane. The first page appears if the viewer prefers French. The second page 
displays for Spanish speakers. The third page, which has no systemLanguage 
attribute, is the default choice that appears for all other viewers: 


<body> 
<video id="main" src="video2.rm" region="video_region" fill="freeze"> 
<switch> 
<area systemLanguage="fr" href="http://www.example.com/french.htm" 
actuate="onLoad" external="true" rn:sendTo="_rpcontextwin" 
sourcePlaystate="play"> 
<rn:param name="width" value="300"/> 
<rm:param name="height" value="280"/> 
</area> 
<area systemLanguage="es" href="http://www.example.com/spanish.htm" 
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actuate="onLoad" external="true" rn:sendTo="_rpcontextwin" 
sourcePlaystate="play"> 
<rn:param name="width" value="300"/> 
<m:param name="height" value="280"/> 
</area> 
<area href="http://www.example.com/default.htm" actuate="onLoad" 
external="true" rn:sendTo="_rpcontextwin" sourcePlaystate="play"> 
<rn:param name="width" value="300"/> 
<rm:param name="height" value="280"/> 
</area> 
</switch> 
</video> 
</body> 


Note that the body of this SMIL file consists of just one clip source tag 
(<video>...</video>). Within these tags, a switch group (<switch>...</switch>) 
contains three hyperlinks (<area>...</area>). Once RealOne Player chooses a 
hyperlink based on the viewer language preference, the linked page opens 
automatically, setting the related info pane’s size. 


For More Information: To find out more about SMIL links that 
open HTML pages, see “Linking to HTML Pages” on page 371. 


System Captions Using RealText 


As the section “Enhancing Presentation Accessibility” on page 448 explains, 
you can use the systemCaptions attribute to display captions for hearing- 
impaired viewers. A viewer can turn on the captions preference by giving the 
Tools>Preferences command, then selecting the Content pane. 


The following examples demonstrate various ways to display RealText 
captions for an audio track, but you can use any type of clip to provide 
captions. The systemCaptions="on” attribute simply tells RealOne Player to play 
a certain clip if the viewer has turned the captions preference on. There are no 
requirements for what type of clip to use for captions, though. 


Tip: Captions are different from subtitles. Captions, which are 
typically in the same language as the clip audio, are meant for 
hearing-impaired viewers who have set the captions preference 
on. Subtitles are for all viewers, and are generally in languages 
different from the clip audio. You can display subtitles based 
on the viewer’s language preference, which is described in 
“Switching Between Language Choices” on page 443. 
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For More Information: Chapter 6 explains how to write a 
RealText clip. See Chapter 12 for information about layouts. 


Example 1: Transparent RealText Overlay 


Although it may not be suitable in all cases, the simplest way to provide 
captioning is to overlay a clip with a RealText clip that has a background 
rendered transparent or semi-transparent through the rn:backgroundOpacity 
attribute. To do this, you define two regions, one for the video, and one for the 
captions, using the z-index attribute to ensure that the captions appear in 
front, as shown in the following example: 
<layout> 

<root-layout width="320" height="240" backgroundColor="black"/> 

<region id="video_region1" z-index="1"/> 

<region id="text_region" height="40" bottom="0" left="10" z-index="2"/> 
</layout> 


You then play the RealText clip in parallel with the main clip, using 
systemCaptions=“on” to display the RealText clip only in RealOne Players that 
have a preference for system captions. Because system captions are either on or 
off, you can easily use inline switching (no <switch> tag), as shown here: 
<par> 

<video src="video.rm" region="video_region1" fill="remove"/> 

<textstream src="transparentcaptions.rt” region="text_region" 

systemCaptions="on" rn:backgroundOpacity="45%" fill="remove"/> 

</par> 


For More Information: For more on rn:backgroundOpacity, see 
“Adjusting Clip Transparency and Opacity” on page 223 


Example 2: Caption Region 


If you do not want to overlay the video as described in the preceding example, 
you can create a separate region for the captions through your SMIL file 
layout. The following layout is similar to that used in the preceding example, 
except that the captions region appears below the video region rather than on 
top of it: 
<layout> 

<root-layout width="320" height="300" backgroundColor="black"/> 

<region id="video_region" height="240"/> 

<region id="text_region" height="40" top="260" left="10"/> 
</layout> 
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If you play a video in parallel with a captions clip as shown in the preceding 
example, the captions region would appear blank for viewers who have the 
captions preference turned off. Alternatively, you can create a “filler clip” that 
displays in the captions region when captions are off. This clip might simply 
thank the viewer for watching the presentation. The following example 
demonstrates how to do this: 
<par> 
<video src="video3.rm" region="video_region" fill="remove"/> 
<switch> 
<textstream src="videocaptions.rt" region="text_region" systemCaptions="on" /> 
<textstream src="fillercaptions.rt" region="text_region" systemCaptions="off" /> 
</switch> 
</par> 


Example 3: Media Playback Pane Resized for Captions 


This example demonstrates how to use systemCaptions in <layout> tags to 
change layouts depending on whether or not captions are displayed. The 
following layout creates a captions region only when captions are turned on. 
Note that in each layout, the video region has a unique ID, which is required 
by SMIL. But both video regions have the same name: 
<switch> 
<layout systemCaptions="on"> 
<root-layout width="320" height="300" backgroundColor="black"/> 
<region id="video_region1" regionName="video" height="240"/> 
<region id="text_region" height="40" top="260" left="10"/> 
</layout> 
<layout systemCaptions="off"> 
<root-layout width="320" height="240" backgroundColor="black"/> 
<region id="video_region2" regionName="video" /> 
</layout> 
</switch> 


Tip: Although the preceding example uses systemCaptions in the 
<layout> tag, you could use the attribute in <root-layout/> and 
<region/> tags instead to display or hide individual regions 
based on RealOne Player’s captions setting. 


In the SMIL body, you then assign clips to the regions. Note that the following 
markup assigns the single video clip to a region through the region name 
instead of the region ID. If you didn’t use the region name, you’d need to 
create two <video/> tags, one assigned to video_region1, the other assigned to 
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video_region2. Each tag would require a systemCaptions attribute to turn the 
tag on or off depending on the captions preference. With the following 
method, only the RealText clip uses the systemCaptions attribute: 
<par> 

<video src="video.rm" region="video" .../> 

<textstream src="captions.rt" region="text_region" systemCaptions="on" .../> 
</par> 


For More Information: See “Setting Region IDs and Names” on 
page 280 for more on region names. 


Backward-Compatible SMIL File 


The section “Combining SMIL 2.0 with SMIL 1.0” on page 454 explains the 
basics of using systemComponent and system-required to create a SMIL 1.0 
presentation for RealPlayer 7 and 8 that includes enhanced SMIL 2.0 features 
for RealOne Player. This sample guides you step-by-step through the process 
of adding a semi-transparent GIF logo to a video clip. In RealPlayer 7 and 8, 
which do not support transparency, only the video plays. In RealOne Player, 
the logo appears in front of the video in the lower-right corner of the media 
playback pane. The following is the SMIL 1.0 file that plays the video: 
<smil> 
<head> 
<meta name="title" content="Video Playback"/> 
<meta name="copyright" content="(c)2002 RealNetworks, Inc."/> 
<layout> 
<root-layout width="320" height="240" background-color="white"/> 
<region id="video_region" width="320" height="240" z-index="1"/> 
</layout> 
</head> 
<body> 
<video src="video1.rm" region="video_region" fill="remove"/> 
</body> 
</smil> 


> To update the preceding SMIL 1.0 file: 


1. Add the required namespaces to the <smil> tag. 


You need to add the namespaces for SMIL 2.0 and the RealNetworks 
extensions, which provide support for transparency. RealPlayer 7 and 8 
ignore these namespaces. All players starting with RealPlayer 7 recognize 
the systemComponent namespace, however: 
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<smil xmlns=“http://www.w3.org/2001/SMIL20/Language” 
xmlns:rn=“http://features.real.com/2001/SMIL20/Extensions” 
xmlns:cv=“http://features.real.com/systemComponent”> 


Note: In presentations played by RealPlayer 7 and 8, the cv 
prefix for the systemComponent namespace is required. 


. Modify the layout. 


The preceding SMIL 1.0 file contains a single video region, so the GIF logo 
requires another region. Even though the updated file is technically SMIL 
2.0, it uses SMIL 1.0 layout features, as well as SMIL 1.0 attribute names 
like background-color. Although you could add SMIL 2.0 layout features 
such as subregions, you’d need to hide them from earlier players. It’s 
therefore easier to use a SMIL 1.0 layout, which is forward-compatible 
with SMIL 2.0 and RealOne Player: 


<layout> 
<root-layout width="320" height="240" background-color="white"/> 
<region id="video_region" width="320" height="240" z-index="1"/> 
<region id="logo_region" width="52" height="46" top="190" left="260" 
fit="meet" z-index="2"/> 
</layout> 


For More Information: For information about SMIL 1.0 
attributes, see RealSystem iQ Production Guide for Release 8. 


. Add the image clip. 


The SMIL 1.0 file’s content consists of a video clip. To display the logo, 
you play the video and the GIF image in parallel. The system-required and 
cv:systemComponent attributes ensure that the logo clip is played only by a 
RealNetworks media player with a version number of at least as high as 
6.0.10, which is the RealOne Player major version number. To RealPlayer 7 
and 8, the body contains just the video clip: 


<body> 
<par> 
<video src="video3.rm" region="video_region" fill="remove"/> 
<img system-required="cv" 
cv:systemComponent="http://features.real.com/?component;player=6.0.10" 
src="prodlogo.gif" rn:mediaOpacity="50%" id="rn_logo" 
region="Logo_region" dur="10s" fill="freeze"/> 
</par> 
</body> 
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For More Information: For details about rn:mediaOpacity, see 
“Adjusting Clip Transparency and Opacity” on page 223. 


4. Test the SMIL file. 


Always test your presentation by opening it in RealOne Player to verify 
that the SMIL 2.0 features are present, and in RealPlayer 7 or 8 to ensure 
that backward-compatibility works. You will need a separate computer for 
each version of RealPlayer you test. 
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19 


PREFETCHING 


Prefetching allows you to manage bandwidth in a complex 
presentation. This helps you to ensure that the presentation streams 
smoothly. You can stream data for high-bandwidth clips while low- 
bandwidth clips play, for example. To use prefetching, though, you 
must thoroughly understand how clips use bandwidth, as well as 


how to create a presentation timeline. 
Note: Prefetching is not currently functional in RealOne Player. 


For More Information: To learn more about bandwidth use, read 
Chapter 2. Chapter 13 describes the basics of SMIL timing. 


Understanding Prefetching 


Prefetching is a powerful feature for managing bandwidth in a streaming 
presentation. It lets you stream portions of large clips, or all data for small 
clips, before the clips play. RealOne Player stores the prefetched data in 
memory until clip playback begins. Using prefetched data, RealOne Player can 
display clips faster when they begin to play. This can reduce or eliminate the 
buffering that normally occurs when clips start to play. 


Uses of prefetching include downloading small image files. If a presentation 
contains graphic buttons that display while a video plays, for example, you can 
prefetch the graphics files before the video begins. When the video-with- 
buttons segment starts, the graphics do not compete with the video for 
bandwidth. Another use of prefetching is to download an audio or video clip’s 
preroll, which is described in the section “Buffering” on page 46, before the 
clip plays. 

Prefetching data is useful only when streaming across a network. It has no 
discernible effect when clips reside on the viewer’s local computer. To use it 
effectively, you typically need to have a presentation in which low-bandwidth 
sections precede high-bandwidth sections. In these cases, prefetching lets you 
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take advantage of low bandwidth use to download data for upcoming high- 
bandwidth segments. When you stream only a video, for example, prefetching 
offers no advantages. If a RealText clip precedes the video, though, you can 
use prefetching to stream the RealVideo clip’s preroll while the RealText clip 
plays. 


Warning! You should have a strong understanding of timelines 
and bandwidth management when prefetching clip data. 
Incorrect use of this feature may stall your presentation or 
cause RealOne Player to use excessive amounts of memory. 


Using the <prefetch/> Tag 
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To prefetch data, you use a <prefetch/> tag, which is similar to a clip source tag 
like <video/>. Instead of playing a clip, though, the <prefetch/> tag downloads 
all or part of the clip data for playback later. As with a clip source tag, the 
<prefetch/> tag uses a URL to indicate the data to download, and can include 
timing attributes such as dur. Unlike clip source tags, a <prefetch/> tag has its 
own attributes that govern the speed and amount of data downloaded. In the 
following example, a <prefetch/> tag downloads a video clip’s preroll to 
RealOne Player while a RealText clip plays presentation credits: 
<seq> 
<!-- Segment 1: Roll RealText credits and download video preroll. --> 
<par endsync="credits”> 
<texstream src="rtsp://helixserver.example.com/credits.rt” id="credits” .../> 
<prefetch src="rtsp://helixserver.example.com/video1.rm” 
mediaTime="15s” bandwidth="18000” /> 
</par> 
<!-- Segment 2: Play the video. --> 
<video src="rtsp://helixserver.example.com/videol.rm” region="main”/> 
</seq> 


In this example, the <prefetch/> tag downloads the first 15 seconds of the clip 
videol.rm at a rate of approximately 18 Kbps. RealOne Player holds this data in 
memory until the video plays, eliminating the buffering that occurs when the 
clip starts to play. RealOne Player matches the prefetched data to the video 
through the identical URLs in the <prefetch/> and <video/> tags. 


Note that in the preceding example, the <par> tag has an endsync attribute that 
ends the group when the RealText clip finishes. Without this attribute, there 

could be empty playback time if the prefetching does not complete before the 
RealText clip finishes. Because RealOne Player treats a <prefetch/> clip like 
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other source clips when it determines presentation timing, always use a timing 
mechanism, such as endsync or dur, to ensure that prefetching does not 
interfere with presentation playback. 


The following table summarizes the <prefetch/> tag attributes that control 
how much clip data is downloaded. The following sections describe how to 
use these attributes effectively. 


<prefetch/> Attributes 
Attribute Value Default Function Reference 
bandwidth | bps| 100% | Sets the bandwidth used to get data. | page 469 
percentage 
mediaSize | bytes| 100% | Specifies the amount of data to page 471 
percentage prefetch based on the clip’s size. 


Overrides mediaTime. 


mediaTime |h|min|s|ms| |100% | Sets the amount of data to prefetch | page 472 
percentage based on the clip’s duration. 


Managing Prefetch Bandwidth 


The <prefetch/> tag’s bandwidth attribute governs how much bandwidth is 
assigned to fetching the clip’s data. If you do not include the bandwidth 
attribute, prefetching uses all of the connection’s available bandwidth, which 
is rarely desirable. You can specify a specific streaming speed in bits per second 
(bps), or indicate a percentage of the available bandwidth. Note that you can 
prefetch data at any bandwidth, regardless of the clip’s normal streaming 
speed. For an audio clip that normally streams at 20 Kbps, for instance, you 
could prefetch data at any speed, from 1 Kbps to 100 Kbps or faster. 


Specifying Prefetch Bandwidth in Bits Per Second 


To specify the exact streaming speed in bits per second, start with the 
maximum recommended bandwidth for your slowest targeted connection. If 
56 Kbps modems are your lowest-speed targets, for instance, use a 34 Kbps 
maximum streaming speed, as given in the table “Maximum Streaming Rates” 
on page 47. Next, determine how much bandwidth you can dedicate to 
prefetching. If you want to stream the prefetched data in parallel with a 16 
Kbps RealAudio clip, for example, you have a maximum of 18 Kbps for 
prefetching: 
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<par endsync="music’> 


<audio src="...” id="music” dur="50s”"/> 
<prefetch src=”"...” begin="10s” bandwidth="18000" mediaSize=”"20480"/> 
</par> 


In this example, data is prefetched at approximately 18 Kbps until either 20 
Kilobytes of data have been received, or the audio clip stops playing. Note that 
the <prefetch/> tag’s begin time means that the prefetching begins 10 seconds 
after the audio clip starts to play. This dedicates all available bandwidth to the 
audio clip during the first 10 seconds of playback, making the audio clip’s 
own preroll stream faster. Although a begin value is optional, including it can 
help to manage bandwidth in the segment that includes prefetching. 


Specifying Prefetch Bandwidth as a Percentage 


Determining a percentage value to use for the bandwidth attribute is more 
complicated than specifying a specific bandwidth. It has useful benefits, 
though. Suppose that you use a bandwidth="50%” value when prefetching clip 
data. Over a 56 Kbps modem, the prefetching uses about 17 Kbps. Over a 256 
Kbps DSL line, though, the prefetching uses over 100 Kbps, finishing much 
faster. If you used bandwidth="17000" instead, the prefetching would take place 
at the same rate over both connections. 


The value you specify equates to a percentage of the usable bandwidth that 
RealOne Player detects, which may differ from the speeds listed in the table 
“Maximum Streaming Rates” on page 47. For a 56 Kbps modem, for example, 
the detected bandwidth will likely be higher or lower than the maximum 
streaming speed of 34 Kbps. But it will definitely be less than the modem’s raw 
speed of 56 Kbps. Because you don’t know the exact prefetching speed when 
you use a percentage value, you need to decide upon a value carefully. 


To select a percentage value, start with the maximum streaming speed for 
your slowest target connection. If your slowest targets are 56 Kbps modems, 
use a 34 Kbps maximum streaming speed. Then determine how much 
bandwidth is left for prefetching. For instance, you have 18 Kbps available for 
prefetching data while a 16 Kbps RealAudio clip plays. This 18 Kbps is 
approximately 53 percent of the 34 Kbps maximum speed. However, because 
the speed RealOne Player detects may be higher or lower, select a lower 
percentage value, such as 45 percent, as shown in the following example: 
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<par endsync="music”> 


<audio src=...” id="music” dur="50s”"/> 
<prefetch src=”...” begin="10s” bandwidth="45%”" mediaSize=”"20480"/> 
</par> 


Controlling Prefetch Data Download Size 


Two attributes for the <prefetch/> tag, mediaSize and mediaTime, control the 
amount of data that RealOne Player downloads for each clip. Use just one of 
these attributes in each <prefetch/> tag. If you use both mediaSize and 
mediaTime, the mediaTime attribute is ignored. If you do not use either of these 
attributes, RealOne Player attempts to prefetch all the clip’s data, which can 
cause RealOne Player to run out of memory with large clips such as videos. 


Tip: The amount of data you can prefetch depends on the 
amount of computer memory available to RealOne Player. To 
reach the widest audience, do not try to prefetch more than 
one Megabyte of clip data. 


Prefetching a Specific Amount of Data 


The mediaSize attribute allows you to set how much of the clip data to prefetch 
based on the clip’s file size. You must use mediaSize rather than mediaTime for 
clips that do not have internal timelines, such as images. Specify the mediaSize 
value in bytes, or as a percentage of the clip’s total size. 


Specifying mediaSize in bytes and bandwidth in bits per second lets you 
determine exactly how long the prefetching lasts. The following example 
prefetches 10 Kilobytes of clip data at a rate of approximately 6 Kilobits per 
second. The prefetching therefore takes approximately 13.7 seconds to 
complete: 


<prefetch src=”"...” mediaSize="10240" bandwidth="6000"/> 


Note: Remember, the bandwidth attribute is in bits per second, 
whereas the mediaSize attribute is in bytes (8 bits = 1 byte). 


If you want to prefetch entire clips, such as whole GIF files, specify 
mediaSize="100%" or leave the attribute out of the <prefetch/> tag. In these 
cases, you’ll need to know the size of the prefetched clip to determine how 
long the prefetching lasts. 
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Prefetching a Specific Length of a Clip’s Timeline 


For clips that have internal timelines, such as RealAudio, RealVideo, or Flash, 
you can use mediaTime instead of mediaSize to prefetch a specific stretch of the 
clip’s timeline. This is useful for prefetching the clip’s preroll. You can specify 
a percentage value, or a timing value as described in “Specifying Time Values” 
on page 313. The following example prefetches 10 seconds of clip data: 


<prefetch src="...” mediaTime="10s” bandwidth="4000"/> 


Keep in mind that mediaTime does not control how long prefetching lasts. The 
amount of time required for prefetching depends on the amount of data 
downloaded and the bandwidth. If the clip in the preceding example normally 
streams at 16 Kbps, for example, RealOne Player needs approximately 40 
seconds to prefetch the first 10 seconds of the clip. This is because the 
prefetching bandwidth is only a quarter of the clip’s streaming bandwidth. 


Tip: To determine how much preroll a clip requires, open the 
clip in RealOne Player, and use View>Clip>Clip Source to view 
the buffering information. 


Tips for Prefetching Data 


The following sections provide additional pointers for using <prefetch/> tags 
to stream clip data. 


RealAudio and RealVideo Prefetching 


- You cannot prefetch a single stream of a SureStream RealAudio or 
RealVideo clip. If you specify mediaTime="10s", for example, you will get 
the first ten seconds of every stream in the SureStream clip. 


- For large streaming clips such as RealAudio, RealVideo, do not prefetch 
much more than the clip’s preroll, which is typically 5 to 15 seconds. You 
can do this easily with an attribute and value such as mediaTime="10s”. 
Prefetching more data wastes bandwidth and can cause RealOne Player to 
run out of memory. 


- Try not to prefetch data too far in advance of when the clip plays. There’s 
little advantage to prefetching a video’s preroll 15 minutes before it plays 
because viewers may stop the presentation within those 15 minutes. As 
well, RealOne Player has to reserve memory for that clip data for 15 
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minutes, and that memory may be more effectively used for rendering the 
clips that do play during that time span. 


- Using constant bit rate encoding (CBR) or variable bit rate encoding 
(VBR) with a RealVideo clip does not affect prefetching, other than that 
VBR clips typically have a longer preroll than CBR clips. For more on VBR, 
see “Variable Bit Rate Encoding” on page 89, as well as your Helix 
Producer documentation. 


- Because of its low bandwidth requirements, RealText makes an ideal clip 
to display as you prefetch data for high-bandwidth clips such as 
RealAudio and RealVideo. See Chapter 6 for more information about 
RealText. Flash animation, which is described in Chapter 5, can also 
stream effectively at low bandwidths to mask prefetching. 


Prefetch URLs 


+ You can use a <meta name="base” content="URL"/> tag with prefetching to 
set the base URL for all clips. See “Creating a Base URL” on page 217 for 
more information. 


- Because RealOne Player matches prefetched data to clips based on URLs, 
you generally should not use prefetching when URLs are dynamically 
generated and may change. An example of this is a banner ad in which the 
URL changes each time the ad is requested from an ad server. 


+ Prefetching is compatible with the CHTTP caching protocol. For an 
example that demonstrates these two features, see “Prefetching and 
Caching an Image” on page 475. 


SMIL Timing with Prefetching 


+ RealOne Player discards prefetched data after the clip plays the first time, 
even if the clip uses a repeatDur or repeatCount attribute. If the clip plays 
again later in the presentation, you need to prefetch its data again. Small 
files, though, can be cached. For an example of this, see “Prefetching and 
Caching an Image” on page 475. 


- Ifyou plan to use a clipBegin attribute to play a clip from some point other 
than its normal starting point, use the same clipBegin value in the 
<prefetch/> tag. For more on this attribute, see “Setting Internal Clip 
Begin and End Times” on page 316. 
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+ RealOne Player can prefetch clips from any server, including Web servers. 
However, clipEnd and clipBegin attributes do not function for clips on Web 
servers. For more information, see “Limitations on Web Server Playback” 
on page 524. 


+ A<prefetch/> tag can have an ID like any clip source tag. This lets you use 
endsync to end a group when prefetching finishes, as explained in the 
example “Displaying an Image Until Prefetching Completes” on page 474. 
For basic information about IDs, see “SMIL Tag ID Values” on page 202. 


Prefetch Testing 


+ Prefetching data is useful only when streaming across a network. It has no 
discernible effect when all clips reside on the viewer’s local computer or on 
a CD, for example. 


- Although playing the SMIL presentation on your local computer will help 
you catch SMIL syntax errors, it does not guarantee that prefetching is 
achieving the results you desire. 


- When you use <prefetch/>, test your presentation by streaming it over a 
network at your target connection’s bandwidth (by dialing in on a 56 
Kbps modem, for example). 


Prefetching Examples 


The following examples show different ways to use prefetching. 


Displaying an Image Until Prefetching Completes 


In the following example, standby.gif is a small image file that asks the viewer 
to wait while the presentation loads. The endsync attribute that targets the 
<prefetch/> tag makes the image display until the video prefetching has 
completed. The <prefetch/> tag’s begin time gives 100% of the available 
bandwidth to the GIF download for five seconds. After that, the prefetching 
takes almost all of the usable bandwidth: 
<seq> 
<!-- Segment 1: Standby. --> 
<par endsync="fetchvid”’> 
<img src="http://www.example.com/standby.gif” fill="freeze” region=”"main” /> 
<prefetch src="rtsp://helixserver.example.com/video.rm” id="fetchvid” 
bandwidth="95%”" mediaTime= “15s” begin="5s”"/> 
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</par> 

<!-- Segment 2: Play video. --> 

<video src="rtsp://helixserver.example.com/video.rm” region="main” /> 
</seq> 


Prefetching and Caching an Image 


The section “Caching Clips on RealOne Player” on page 219 explains how to 
store clips in the RealOne Player cache for later use. While caching and 
prefetching are different activities, they can be used together effectively to 
download and retain small files that are used repeatedly. Caching should 
never be used with large clips, however, because RealOne Player’s cache is only 
a few Megabytes in size. 


The following SMIL sample, which omits layout attributes, prefetches a GIF 
image used as the background for two videos. Because the CHTTP protocol is 
used, the image is cached and does not need to be prefetched a second time: 


<seq> 
<!-- Segment 1: Play introductory section and download background. --> 
<par endsync="credits”> 
<textstream src="rtsp://helixserver.example.com/credits.rt” id="credits” .../> 
<prefetch src="chttp://helixserver.example.com/imagel.gif” 
bandwidth="10000"/> 
</par> 
<!-- Segment 2: Play video 1 against background. --> 
<par> 
<video src="rtsp://helixserver.example.com/videol.rm” .../> 
<img src="chttp://helixserver.example.com/image1.gif” fill="freeze”/> 
<par> 
... other segments ... 
<!-- Segment 6: Play video 2 against background. --> 
<par> 
<video src="rtsp://helixserver.example.com/video2.rm” .../> 
<img src="chttp://helixserver.example.com/imagel.gif” fill="freeze”/> 
<par> 
</seq> 


Note: Keep in mind that prefetching stores clip data in 
memory until the clip plays. Caching stores a copy of the clip 
on the computer’s hard disk. That copy may remain in the 
cache for several hours or even days. 
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STREAMING YOUR PRESENTATIONS 


Your hard work doesn’t pay off until you’ve streamed your clips 
to others.Chapter 20 explains the option of embedding your 
presentation in a Web page. Chapter 21 provides step-by-step 
instructions for moving your streaming presentation to a server 
and linking your Web page to it. 


CHAPTER 


20 


WEB PAGE EMBEDDING 


With embedded playback, you can weave your clips through your 
Web page’s text and graphics, and add controls such as stop and 
start buttons. It’s as if you took RealOne Player apart and placed its 
pieces at different spots on your page. This chapter explains how to 
add markup to a Web page so that people can view your streaming 
presentation directly through their Web browsers. 


Understanding Web Page Embedding 


To add media in your Web page, you first produce your clips. You can even use 
SMIL to coordinate multiple clips. You then embed your presentation by 
adding <EMBED> and, optionally, <OBJECT> tags to your Web page. You can use 
HTML markup or style sheets to place your clips, along with various RealOne 
Player controls, anywhere on your page. The following sections provide an 
overview of Web page embedding, and describe its disadvantages compared to 
displaying media in RealOne Player’s three-pane environment. 


Embedding vs. the Three-Pane Environment 


Although Web page embedding is a popular way to integrate media with 
HTML content, displaying your presentation in RealOne Player’s native three- 
pane environment provides a simpler means for coordinating media and 
HTML pages. So, before you embed a presentation, determine if the native 
RealOne Player environment suits your needs better. For the content author, 
the three-pane environment provides the following advantages: 


- Eliminates cumbersome markup and scripting. 


The markup used to embed media in a Web page is cumbersome. Some 
features, such as detecting a browser version and updating the HTML 

content as a clip plays, can require complex scripting. In the three-pane 
environment, you keep your media and HTML pages separate, tying the 
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two together with simple production techniques. This greatly reduces the 
work required to coordinate media and HTML pages. It also lets you put 
together complex presentations even if you’re not a Web professional. 


- Simplifies testing and delivery 


When you embed a presentation in a Web page, you must test it in 
popular browsers, including Internet Explorer, Netscape Navigator, and 
Opera. When you use the three-pane environment, you need to test 
playback only in RealOne Player. 


+ Allows users to replay media quickly. 


RealOne Player adds clips to its “Now Playing” list, letting viewers quickly 
return to them without having to navigate back through a long list of 
HTML pages. Viewers can also add your media clips to their list of 
favorites. 


For the presentation viewer, using the three-pane environment provides 
several advantages as well: 


- Places the focus on the media. 


In RealOne Player, the media always appears in the media playback pane, 
so it never gets lost. Additionally, the three-pane environment provides 
viewers with a consistent interface and set of controls, allowing them to 
navigate your site more easily. 


Enables the full range of RealOne Player features. 


Embedded presentations do not give the viewer access to popular RealOne 
Player features, such as media resizing, the equalizer, audio visualizations, 
and RealOne Player skins. 


Eliminates pop-up blocking. 
Many consumers automatically block pop-up browser windows. If you 


embed your media in a pop-up Javascript window, for example, consumers 
may need to disable their blocking software to view your presentation. 


For More Information: For more information about the three- 
pane environment, see “Step 2: Learn the RealOne Player 
Interface” on page 29. 
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<EMBED> and <OBJECT> Tags 


You can embed a RealOne Player presentation in a Web page using <EMBED> 
tags, <OBJECT> tags, or both. When you use <EMBED>, your presentation will 
work in browsers that support the Netscape plug-in architecture, including 
the following: 


+ Netscape Navigator 3.0 and later. 


+ Microsoft Internet Explorer 3.0 and later. 


Note: Even when you use the <EMBED> tag, RealOne Player 
communicates with Internet Explorer browsers using ActiveX 
technology. This makes the Netscape <EMBED> tag compatible 
with both major browsers, including Internet Explorer 6 and 
later. 


Using <EMBED> tags allows you to reach the widest Internet audience, and this 
chapter’s examples primarily use just <EMBED> tags. However, can also use 
<OBJECT> tags, which provide playback capabilities within these products: 


+ Microsoft Internet Explorer 4.0 and later on Microsoft Windows. 


+ Most applications that support ActiveX controls, such as Visual Basic and 
Visual C++. 


As the section “Using <OBJECT> Tags” on page 487 explains, you can 
combine <EMBED> and <OBJECT> tags in your Web page, which is a production 
technique used by many Web professionals. 


Layout Possibilities 


When you embed a presentation, you use HTML to structure your Web page 
and define where each streaming clip and RealOne Player control appears. A 
common practice is to define an HTML table, embedding clips and RealOne 
Player controls in various table cells. When you embed a SMIL presentation, 
you can define a layout using SMIL and HTML, or just HTML alone. 


Defining a Layout with SMIL and HTML 


As described in Chapter 12, you can use SMIL to define an overall size for the 
media playback pane (the root-layout). You might create a layout that is 400 

pixels wide by 300 pixels high, for example, and define smaller regions within 
that main area for clips. You then embed the entire playback area within your 
Web page using a single <EMBED> tag, adding RealOne Player controls around 
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it with separate <EMBED> tags. All clips then appear within that 400-by-300 
pixels area, just as they would when played in RealOne Player. In fact, your 
SMIL file can play in both your Web page and RealOne Player. 


For More Information: See “Defining the Layout with SMIL” on 
page S01. 


Defining a Layout with HTML Alone 


You can leave layout information out of your SMIL file, and use SMIL simply 
to define your presentation timing and other playback features. In your Web 
page, you then create a separate <EMBED> or <OBJECT> tag for each clip, placing 
each clip anywhere on your page. In this case, all clips do not need to appear 
within a rectangular root-layout area. This gives you more layout flexibility 
than when defining the overall clip layout through SMIL. However, because 
your SMIL file lacks layout information, it may have unexpected layout results 
if played directly in RealOne Player. 


For More Information: See “Defining the Layout with HTML” 
on page S02. 


RealOne Player Controls 


In addition to clips, you can embed many different RealOne Player buttons, 
sliders, and information panels in your Web page. You might include separate 
start, stop, and pause buttons in your Web page, for example. Or, you could 
add entire control panels that contain multiple buttons and readouts. You can 
make these controls any size you want, too, giving you even more layout 
flexibility. The section “Adding RealOne Player Controls” on page 489 
explains all the available controls. 


Javascript and VBScript 


RealOne Player supports Javascript, which enables you to extend the <EMBED> 
tag capabilities to turn your own graphic image into a RealOne Player Play 
button, for example. RealOne Player’s ActiveX control also provides playback 
capabilities for the products that support <OBJECT> tags. This guide does not 
explain these scripting capabilities. For information on using Javascript or 
VBScript, see RealOne Player Scripting Guide, which is available for download 
from the following Web page: 


http://service.real.com/help/library/encoders.html 
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Using <EMBED> Tags 


Each <EMBED> tag has three required parameters, and can include many 
optional parameters, which are described throughout this chapter. The 
following table lists the parameters to include in every <EMBED> tag. 


Basic <EMBED> Tag Parameters 


Parameter Value Function Reference 
HEIGHT [pixels —|Setsthe height of the clip orcontrol. —_—‘| page 486 
NOJAVA | false|true Keeps the Java virtual machine from starting. | page 486 
SRC filename.rpm | Locates the Ram file (.rpm). page 483 
WIDTH pixels Sets the width of the clip or control. page 486 


A basic <EMBED> tag looks like the following, which creates a playback area 320 
pixels wide by 240 pixels high within the Web page: 
<EMBED SRC="presentation.rpm” WIDTH=320 HEIGHT=240 NOJAVA=true> 


You add to your Web page one <EMBED> tag for each playback window you 
want in your page, and one <EMBED> tag for each control, such as a Stop 
button, that you want to include. 


Setting <EMBED> Tag Parameters 


<EMBED> tags are an extension of HTML. Because they are not SMIL tags, they 
do not use the same syntax rules as SMIL. The <EMBED> tag parameters are 
typically in this form: 

PARAMETER=value 


Parameter names can be any case, although this guide shows them uppercase. 
Except for file names, parameter values are not case-sensitive. Unless they are 
URLs, parameter values do not need to be enclosed in quotation marks. 


Specifying the Source 


You must include the SRC parameter in every <EMBED> tag, even when the tag 
embeds a RealOne Player control instead of a clip. However, you don’t specify 
a clip or SMIL file directly with SRC. Instead, you specify a Ram file that has a 
.rpm extension. This causes the browser to use RealOne Player as a helper 
application, rather than to launch it as a separate program. The .rpm file is a 
simple text file that gives the full URL to your clip or SMIL file. 
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For More Information: For information about Ram file syntax, 
see “Launching RealOne Player with a Ram File” on page 507. 


Developing Your Presentation 


The easiest means for developing your embedded presentation is to keep your 
clips in the same folder as your Web page on your desktop computer. Your 
<EMBED> tag can then link to a .rpm file in that folder: 


<EMBED SRC="presentation.rpm” WIDTH=300 HEIGHT=134> 


To embed a single video, for example, the .rpm file simply contains a local file 
URL to the clip (the file:// protocol designation is required): 


file://video.rm 


Warning! For embedded playback to work with Netscape 
Navigator 6, the path to the .rpm file on a server or your local 
computer cannot contain spaces or even escape codes for 
spaces (%20). This causes Navigator 6 to search for a missing 


plug-in. 


Delivering Your Presentation 


When you are ready to deliver your presentation to your audience, move your 
files to their respective servers and change the URLs in your files. Note that 
directory paths cannot contain spaces. 


Keeping the .rpm File and the Web Page Together 

If you plan to keep the .rpm file with the Web page, you do not need to change 
the SRC values in your <EMBED> tags. You can simply transfer your .rpm file and 
your Web page to the same directory on your Web server. 


Putting the .rpm File and the Web Page in Different Locations 
If you move the .rpm file to a different directory than that Web page, link each 
<EMBED> tag’s SRC parameter to the .rpm file with a full HTTP URL: 


SRC="http://www.example.com/media/presentation.rpm” 


Linking to Streaming Clips 

No matter where you put your .rpm file and your clips, modify the .rpm file to 
give the fully-qualified URL to the embedded clip or SMIL file. If the clip or 
SMIL file is on a Web server, use an HTTP URL. If the clip or SMIL file is on 
Helix Universal Server, use an RTSP URL. 
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Tip: Always use a full URL in the .rpm file, even if all files and 
clips are in the same directory on a Web server. RealOne Player 
uses the .rpm file to locate the clip or presentation. Without a 
fully-qualified URL, RealOne Player must construct the 
location from the original Web page URL and the information 
in the .rpm file. This creates more possibility for errors. 


For More Information: For more information on URLs in .rpm 
files, see “Launching RealOne Player with a Ram File” on page 
507. The section “The Difference Between RTSP and HTTP” 
on page 505 explains why Helix Universal Server uses the RTSP 
protocol instead of a Web server’s HTTP protocol. 


Linking to Local Clips 

If you will make your presentation available to people on their local machines 
(through a download or a CD, for instance), you do not need to change any 
URLs from those described in “Developing Your Presentation” on page 484. In 
rare cases, though, you may want to use an absolute link, rather than a relative 
link, in the .rpm file. When writing absolute links, use forward slashes in paths 
to create “Web style” paths. For example, instead of this URL: 


file://c:\media\presentation.rpm 


use the following URL, which includes three forward slashes in file:///, and 
uses forward slashes in path names as well: 


file:///c:/media/presentation.rpm 


Using Helix Universal Server’s Ramgen to Eliminate the Ram File 


When your embedded clips reside on a Helix Universal Server that uses the 
Ramgen feature, you can eliminate the .rpm file when you deliver your 
presentation. Your SRC parameter uses an HTTP URL to the clip or SMIL file 
on Helix Universal Server, and includes a /ramgen/ parameter along with the 
?embed option: 


SRC="http://helixserver.example.com:8080/ramgen/sample.smil?embed” 


The HTTP protocol is required because a browser cannot make an RTSP 
request. When /ramgen/ and the ?embed parameter are used, though, Helix 
Universal Server causes the browser to start RealOne Player as a helper 
application, then streams the clip or SMIL file to RealOne Player using RTSP. 
Consult your Helix Universal Server administrator for the correct URL to your 
Helix Universal Server. 
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For More Information: For details on using the Ramgen option, 
see “Using Ramgen for Clips on Helix Universal Server” on 
page 519. 


Setting the Width and Height 


Required for each <EMBED> tag, the WIDTH and HEIGHT parameters set the size 
of the playback area. If you omit these parameters, the playback area may 
appear as a tiny icon because streaming media presentations do not resize 
themselves automatically. The values for WIDTH and HEIGHT are in pixels by 
default, so a width of 300 creates a playback area 300 pixels wide. Setting 
WIDTH and HEIGHT to 0 (zero) hides the playback area. 


You can also express WIDTH and HEIGHT as percentages of the browser window 
size. For example, a width of 50% makes the width of the presentation area 
half the width of the browser window. Keep in mind that different types of 
media scale with different results. For example, a video scaled to a different 
width-to-height ratio may not look good. Vector-based clips such as Flash 
animations, on the other hand, scale more easily to fit different playback 


areas. 


Turning off the Java Virtual Machine 


Setting the NOJAVA parameter to true in every <EMBED> tag prevents the 
browser’s Java Virtual Machine (JVM) from starting if it is not yet running: 


<EMBED SRC="presentation.rpm” WIDTH=300 HEIGHT=134 NOJAVA=true> 


This parameter primarily affects Netscape Navigator 4, which does not launch 
its JVM until it’s needed. The parameter is recommended because starting the 
JVM delays presentation playback unnecessarily. The parameter has no effect 
on Internet Explorer, or Navigator 6 or higher. 


Note: The JVM is required only when you are extending plug-in 
functionality with Javascript. In this case, omit NOJAVA entirely 
from the <EMBED> tags. See “Javascript and VBScript” on page 
482 for more information about using Javascript with the 
<EMBED> tag. 
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Supporting Other Browsers 


To accommodate browsers that do not support the Netscape plug-in, use 
<NOEMBED> to define a standard hypertext link to your presentation. The 
unembedded link follows the <EMBED> tag: 

<EMBED SRC="presentation.rpm” WIDTH=320 HEIGHT=240> 


<NOEMBED><A HREF="presentation.ram”>Play with RealOne Player. </A> 
</NOEMBED> 


In this example, browsers that can play the embedded presentation hide the 
text between <NOEMBED> and </NOEMBED>. Other browsers ignore the preceding 
<EMBED> tag and display only the hypertext link. The viewer then clicks the 
link to play the presentation in RealOne Player. 


Using <OBJECT> Tags 


Although using just <EMBED> tags for RealOne Player presentations provides 
compatibility with both major browsers, you can combine <OBJECT> tags along 
with <EMBED> tags. This is a common practice used by Web developers when 
working with helper applications that, unlike RealOne Player, do not use 
ActiveX technology when Web pages with <EMBED> tags are rendered by 
Internet Explorer. 


An <OBJECT> tag uses an ID that you select, such as ID=RVOCX, and it must have 
the following class ID, which identifies RealOne Player: 


CLASSID="clsid:CFCDAA03-8BE4-11cf-B84B-0020AFBBCCFA” 


As with the <EMBED> tag, the <OBJECT> tag also sets the width and height of the 
playback area within the browser. The following <OBJECT> tag creates a 
playback area 300 pixels wide by 134 pixels high within the Web page: 
<OBJECT ID=RVOCX CLASSID="clsid:CFCDAA03-8BE4-11cf-B84B-0020AFBBCCFA” 
WIDTH=300 HEIGHT=134> 


... parameters ... 
</OBJECT> 


Setting <OBJECT> Tag Parameters 


The <OBJECT> tag uses the same parameters as an <EMBED> tag, with the 
exception that the NOJAVA parameter is not required. With an <EMBED> tag, you 
set all parameters within the tag. With <OBJECT>, however, you specify each 
parameter (aside from ID, CLASSID, WIDTH, and HEIGHT) in a separate <PARAM> 
tag that falls between <OBJECT> and </OBJECT>: 
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<PARAM NAME="name” VALUE="value”> 


PARAM, NAME, and VALUE markers can be any case, although in this chapter they 
are uppercase. Except for file names, parameter values are not case-sensitive. 
Always enclose parameter values in double quotation marks. 


Specifying the Source 


For the <OBJECT> tag’s SRC parameter, you can specify a .rpm file the same as 
you do with an <EMBED> tag. This is not necessary, however, because the 
<OBJECT> tag’s CLASSID parameter causes the presentation to play in a Web 
page. Hence, you can simply link to the SMIL file or clip within just one 
<OBJECT> tag on the page, using the appropriate protocol, whether HTTP or 
RTSP. (In contrast, each <EMBED> tag must include the same SRC parameter.) 


Note: Although you can use a Ramgen URL in a SRC parameter 
for the <OBJECT> tag, it is not necessary because the CLASSID 
parameter launches RealOne Player whether or not you use 
Ramgen. 


Combining <EMBED> with <OBJECT> 


If you combine <EMBED> and <OBJECT> tags, Internet Explorer browsers on 
Windows play the presentation defined through <OBJECT>, while Netscape 
Navigator browsers on all platforms, as well as Internet Explorer on the 
Macintosh, play the presentation defined through <EMBED>. To combine the 
tags, place an <EMBED> tag containing all necessary parameters between the 
<OBJECT> and </OBJECT> tags, as shown in the following example: 


<OBJECT ID=RVOCX CLASSID="clsid:CFCDAA03-8BE4-11cf-B84B-0020AFBBCCFA" 
WIDTH=320 HEIGHT=240> 

<PARAM NAME="SRC" VALUE="plugin.rpm"> 

<PARAM NAME="CONTROLS" VALUE="ImageWindow"> 

<PARAM NAME="CONSOLE" VALUE="one"> 

<EMBED SRC="plugin.rpm" WIDTH=320 HEIGHT=240 NOJAVA=true 
CONTROLS=ImageWindow CONSOLE=one> 

</OBJECT> 
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Adding RealOne Player Controls 


With the CONTROLS parameter, you can add RealOne Player controls such as a 
play/pause button to your Web page. For example, the following tag displays 
the play/pause button in your Web page: 


<EMBED SRC="presentation.rpm” WIDTH=26 HEIGHT=26 NOJAVA=true 
CONTROLS=PlayButton> 


The following sections describe the embedded RealOne Player controls. You 
use an <EMBED> or <OBJECT> tag’s WIDTH and HEIGHT parameters to set the 
control’s size. Specifying different pixel sizes other than the suggested values 
scales the controls larger or smaller. You can also use percentage values for 
sizes, but this is recommended only for the image window. 


For More Information: When adding more than one control to 
your Web page, see also “Linking Multiple Controls” on page 
495. 


Tip: Unless noted otherwise, all the controls listed below are 
compatible with RealPlayer G2, RealPlayer 7, and RealPlayer 8. 
With those versions of RealPlayer, however, the controls take 
on a different appearance. 


Basic Controls 


ImageWindow 


The CONTROLS=ImageWindow parameter displays a playback window. This 
control is not required for audio-only presentations. Even if no other controls 
are visible on the page, the user can typically right-click (on Windows) or hold 
down the mouse button (on the Macintosh) in the playback area to display a 
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menu of choices such as Play and Stop. See also “Controlling Image Display” 
on page 497. 


Suggested pixel width: 176 or greater 
Suggested pixel height: 132 or greater 


All 


(PR (8) (4)  @ | > «) 


Clip Info:| Embedded Real0NE Player Controls | @ | 
[o 0.0 Kbps | e 00:00.0/00:21.0 


The CONTROLS=ALl parameter displays the basic RealOne Player control panel. 
The control name “default” also works. Functions include play/pause, stop, 
fast-forward, and rewind. Sliders include a position slider and a volume slider 
with a mute button that pops up when the speaker button is clicked. Below 
the buttons are a clip information field, a status panel, a network congestion 
indicator, and a clip timing field. 


Suggested pixel width: 375 
Suggested pixel height: 100 


If you set the size of this control panel to less than the recommended width or 
height, the panel drops certain controls instead of squeezing all of the 
controls down to a smaller size. This lets you add the control panel to small 
pop-up windows, for example, without the controls becoming difficult to use. 
This works for RealOne Player, but not earlier versions of RealPlayer. 


Width less than 336 pixels: network congestion indicator dropped 
Width less than 306 pixels: clip timing field dropped 


Width less than 226 pixels: Clip Info label, rewind and fast-forward buttons 
dropped 


Width less than 174 pixels: RealOne logo dropped 
Height less than 81 pixels: clip information field dropped 
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Individual Controls and Sliders 


ControlPanel 


Use CONTROLS=ControlPanel to display a compact RealOne Player control panel. 
Functions include play/pause, stop, fast-forward and rewind. There’s also a 
position slider, along with a volume slider and mute button that pops up 
when the speaker button is clicked. 


Suggested pixel width: 350 
Suggested pixel height: 36 


If you set the size of this control to less than the recommended width, the 
panel drops certain buttons instead of squeezing all of the buttons down to a 
smaller size. This works for RealOne Player, but not earlier versions of 
RealPlayer. 


Width less than 220 pixels: rewind and fast-forward buttons dropped 
Width less than 168 pixels: RealOne logo dropped 


PlayButton (also PlayOnlyButton) 

> | The CONTROLS=PlayButton parameter displays a play button. This turns into a 

7 pause button when the presentation plays. If your presentation is accessible to 

RealPlayers earlier than the RealOne Player, use CONTROLS=PlayOnlyButton 
instead. In earlier RealPlayers, the PlayButton control includes both play and 
pause buttons, whereas the PlayOnlyButton control includes just the play 
button as shown here. Using PlayOnlyButton therefore ensures backwards 
compatibility. 
Suggested pixel width: 36 
Suggested pixel height: 26 


PauseButton 

The CONTROLS=PauseButton parameter displays a pause button. Because the 
PlayButton control turns into a pause button as a presentation plays, the 
PauseButton control is generally not necessary with RealOne Player. To ensure 
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backwards compatibility with earlier versions of RealPlayer, however, use both 
the PlayOnlyButton and the PauseButton controls. 

Suggested pixel width: 26 

Suggested pixel height: 26 


StopButton 

a | the CONTROLS=StopButton parameter displays a stop button. 
Suggested pixel width: 26 
Suggested pixel height: 26 


FFCtrl 
»)| The CONTROLS=FFCtrl parameter displays a fast-forward button. 


Suggested pixel width: 26 
Suggested pixel height: 26 


RWCtrl 
@)| The CONTROLS=RWCtrl parameter displays a rewind button. 


Suggested pixel width: 26 
Suggested pixel height: 26 


MuteCtrl 
« | The CONTROLS=MuteCtrl parameter displays a mute button. 


Suggested pixel width: 26 
Suggested pixel height: 26 


MuteVolume 

The CONTROLS=MuteVolume parameter displays a mute button and volume 

| slider. 
Suggested pixel width: 26 

©) | Suggested pixel height: 88 


VolumeSlider 
The CONTROLS=VolumeSlider parameter displays a volume slider. 


| Suggested pixel width: 26 
Suggested pixel height: 65 
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PositionSlider 


The CONTROLS=PositionSlider parameter displays a clip position slider. 


Suggested pixel width: 120 
Suggested pixel height: 26 


TACCtrl 


Clip Info:| Embedded RealONE Player Controls t ey | 


The CONTROLS=TACCtrl parameter displays an information field. Clip or 
presentation information scrolls vertically through this field when the clip 
first plays. The viewer can redisplay this information by clicking the arrow 
button. Clicking the “i” button displays the full presentation information in a 
pop-up window. With RealOne Player, the Clip Info field is dropped if you set 


the width of the TACCtrl to less than 220 pixels. 


Suggested pixel width: 370 
Suggested pixel height: 32 


For More Information: For instructions on defining clip or 
presentation information, see Chapter 10. 


HomeCtrl 

| | The CONTROLS=HomeCtrl parameter displays the RealOne Player logo, which is 
linked to the RealNetworks Web site. In earlier versions of RealPlayer, this 
control displays the Real™ logo. 


Suggested pixel width: 30 
Suggested pixel height: 30 


Information Panels 


InfoVolumePanel 


Embedded RealONE Player Controls 
RealNetworks, Inc. | 
{c]2001 RealNetworks, Inc. 
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Use CONTROLS=InfoVolumePanel to display presentation information along with 
the volume slider and mute button. For more on presentation information, 
see “Defining Information for the SMIL Presentation” on page 240. 


Suggested pixel width: 325 
Suggested pixel height: 55 


InfoPanel 


Embedded RealONE Player Controls 
RealNetworks, Inc. 
(c]2001 RealNetworks, Inc. 


The CONTROLS=InfoPanel parameter displays the presentation information 
panel. For more on presentation information, see “Defining Information for 
the SMIL Presentation” on page 240. 

Suggested pixel width: 300 

Suggested pixel height: 55 


Status Panels 


StatusBar 


[fc 150.0 Kbps +B | ° [ 00:14.8/00:21.0 


The CONTROLS=StatusBar parameter displays the status panel, which shows 
informational messages. It also includes the network congestion LED and the 
position field, which shows the clip’s current place in the presentation 
timeline, along with the total clip length. 

Suggested pixel width: 335 

Suggested pixel height: 30 


If you set the width of the status bar lower than the recommended width, the 
panel drops fields instead of squeezing all of the fields down to a smaller size. 
This works for RealOne Player, but not earlier versions of RealPlayer. 

Width less than 330 pixels: network congestion indicator dropped 


Width less than 300 pixels: clip timing field dropped 
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Note: The status bar is included in the All control. If you do not 
embed a status bar or status field in your page, error messages 
display in the browser’s status bar. 


StatusField 


| [}] 150.0 Kbps + 


The CONTROLS=StatusField parameter displays the message text area of the 
status bar. If you do not embed a status field or status bar in your page, error 
messages display in the browser’s status bar. 


Suggested pixel width: 200 
Suggested pixel height: 30 


PositionField 


| 00:07.9/00:21.0 | 


The CONTROLS=PositionField parameter displays the position field, which shows 
the clip’s current place in the presentation timeline, along with the total clip 
length. 

Suggested pixel width: 90 

Suggested pixel height: 30 


Linking Multiple Controls 


The CONSOLE parameter defines a name that unifies <EMBED> or <OBJECT> tags 
so that multiple controls work together. For example, you could create three 
separate <EMBED> or <OBJECT> tags to define an image window, a play button, 
and a stop button. By using three tags, you can set the size of each control 
separately, and define the entire layout with HTML tags. You could put each 
control in a different HTML table cell, for example. 


To tie controls together, define the same CONSOLE name within each <EMBED> 
or <OBJECT> tag, or use one of these predefined names: 


_master links the control to all other embedded controls on the page. 
_unique links the control to no other embedded controls on the page. 


You can have multiple console names for separate presentations. For a page 
showing two video clips, for example, you can define the console names video1 
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and video2. All controls linked by video1 interoperate, as do all controls linked 
by video2. But a video1 volume slider, for example, will not affect the volume of 
a video2 clip. 


Tips for Using Consoles 


- Every <EMBED> tag must have a SRC attribute. Tags linked by a console 
name should have the same SRC value. 


+ If the <EMBED> tags in a console group have different SRC values, the first 
valid source that RealOne Player finds among those choices becomes the 
console source. This may not always be the first source listed. 


+ Clicking a play button for one console stops playback for other consoles. 
This allows multiple consoles to play separate audio tracks or to use the 
same image window. 


Multiple Controls Example 


The following example sets up an image window and two sets of controls (a 
play button and stop button) for two separate videos, video1.rm and video2.rm. 
The predefined console name _master links the image window to both control 
sets. The control sets use different console names, however, so they do not link 
to each other. Clicking each play button therefore starts a different video. 


Because each <EMBED> tag must have a SRC value, the image window in the 
following example uses the same source as the first play button. The viewer 
simply clicks either play button to start a video. Clicking the other play button 
stops the first video and plays the second one: 


<EMBED SRC="video1.rpm” CONSOLE=_master WIDTH=176 HEIGHT=128 
NOJAVA=true CONTROLS=ImageWindow> 


<H4>Video 1</H4> 

<EMBED SRC="video1.rpm” CONSOLE=video1 WIDTH=44 HEIGHT=26 NOJAVA=true 
CONTROLS=PlayButton> 

<EMBED SRC="video1.rpm” CONSOLE=video1 WIDTH=26 HEIGHT=26 NOJAVA=true 
CONTROLS=StopButton> 


<H4>Video 2</H4> 

<EMBED SRC="video2.rpm” CONSOLE=video2 WIDTH=44 HEIGHT=26 NOJAVA=true 
CONTROLS=PlayButton> 

<EMBED SRC="video2.rpm” CONSOLE=video2 WIDTH=26 HEIGHT=26 NOJAVA=true 
CONTROLS=StopButton> 
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Controlling Image Display 


The <EMBED> parameters summarized in the following table control aspects of 
how clips in an image window play. 


Parameters for Image Display 


Parameter Value Default Function Reference 
BACKGROUNDCOLOR | name|#RRGGBB | black | Sets a window color. page 497 
CENTER false|true false Centers the clip. page 498 
MAINTAINASPECT _ | false|true false | Determines clip scaling. | page 498 
NOLOGO false|true false Suppresses the logo. page 499 


The following example shows two of these parameters used in an <EMBED> tag: 


<EMBED SRC="presentation.rpm” WIDTH=50% HEIGHT=50% NOJAVA=true 
BACKGROUNDCOLOR=gray CENTER=true> 


Setting a Background Color 


The BACKGROUNDCOLOR parameter specifies a background color for the image 
window. The specified color shows through the clip if a clip uses transparency. 
The background color is black by default. You can use a hexadecimal color 
value (#RRGGBB) or one of the following color names, shown here with their 
corresponding hexadecimal values: 


white (#FFFFFF) silver (HCOCOCO) gray (#808080) black (#000000) 
yellow (#FFFFOO) fuchsia (#FFOOFF) red (#FFO000) maroon (#800000) 
lime (#00FFOO) olive (#808000) green (#008000) purple (#800080) 
aqua (#00FFFF) teal (4008080) blue (HOOOOFF) navy (#000080) 


Note: SMIL region background colors override this 
background color. For more on setting SMIL region colors, see 
“Adding Background Colors” on page 290. 


Tip: Appendix C provides background on hexadecimal color 
values. Note, though, that the <EMBED> and <OBJECT> tags do 
not support rgb(n,n,n) color values that you can use with SMIL. 
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Centering a Clip 


The default value for CENTER is false, which causes the clip to fill the entire 
playback area. If you set CENTER to true, the clip is centered within the playback 
area and is displayed at its encoded size. So by setting CENTER to true, you can 
create a large playback area with WIDTH and HEIGHT and still have the clip play 
at its normal size. You cannot use CENTER along with MAINTAINASPECT. 


Maintaining a Clip’s Aspect Ratio 


The MAINTAINASPECT parameter, which you cannot combine with CENTER, 
determines whether the clip’s width-to-height ratio stays constant when the 
clip scales to fit the image window. The default value of false causes this ratio 
to change as necessary to fill the image window fully. This may distort the 
source image. 


If you set MAINTAINASPECT to true, a clip’s width-to-height ratio stays constant. 
For example, a clip’s width-to-height ratio of 1:1 stays constant even if the 
image window’s width-to-height ratio is 3:2. In these cases, the clip is centered 
in the image window and scaled until one dimension reaches the window’s 
boundaries and the other dimension is within the boundaries. The following 
illustration shows how clips scale by default, with MAINTAINASPECT set to true, 
and with CENTER set to true. 
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Clip Scaling with MAINTAINASPECT and CENTER 


Source Clip 


Default Behavior 


MAINTAINASPECT CENTER 
"true" "true" 


Suppressing the RealOne Logo 


When set to true, NOLOGO prevents the RealOne logo from displaying in the 
image window before clips play. When there are no clips playing, only the 
specified background color shows in the window. The parameter is false by 
default. 
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The parameters listed in the following table can cause a presentation to start 
playing automatically, and to loop continuously or for a specified number of 


times. 
Parameters for Automatic Playback 
Parameter Value Default Function Reference 
AUTOSTART | false|true | false | Starts presentation automatically. page 500 
LOOP false|true |false | Creates a continuous playback loop. page 500 
NUMLOOP  |integer 1 Loops playback a set number of times. | page 501 
SHUFFLE false|true |false | Sets shuffle play for a sequence of clips. | page 501 


The following example shows two of these parameters in an <EMBED> tag: 


<EMBED SRC="presentation.rpm” WIDTH=50% HEIGHT=50% NOJAVA=true 
AUTOSTART=true LOOP=true> 


Starting a Presentation Automatically 


When set to true, the AUTOSTART parameter starts playback immediately. When 
you have multiple <EMBED> or <OBJECT> tags linked by a CONSOLE name, set 
AUTOSTART to true in just one tag. Leaving AUTOSTART out, or setting its value to 
false, means that the presentation will not start until the user starts it by 
clicking an embedded play button, for example. 


Looping a Presentation Continuously 


If the LOOP parameter is set to true, the presentation loops continuously until 
the viewer stops it. When you have multiple <EMBED> or <OBJECT> tags linked 
by a CONSOLE name, set LOOP to true in just one tag. If you leave LOOP out, the 
default value of false applies, and the presentation stops after the first 
playback. The user can play the presentation again by clicking a play button. 


Tip: The LOOP or NUMLOOP parameters will make an entire SMIL 
presentation repeat. Within a SMIL file, you can use the 
repeatDur and repeatCount attributes to repeat individual clips 
or groups. For more information, see “Repeating an Element” 
on page 323. 
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Specifying a Number of Loops 


If you specify a parameter such as NUMLOOP=2, the presentation plays the 
specified number of times and then stops. If you use both LOOP and NUMLOOP, 
the LOOP parameter is ignored. 


Setting Shuffle Play 


The SHUFFLE parameter is for use only with Ram or SMIL files that list a single 
sequence of clips. When set to true, SHUFFLE causes RealOne Player to play the 
clips in a random order. If you use this parameter with LOOP or NUMLOOP, each 
loop may use a different playback order. 


For More Information: For information on SMIL sequences, see 
“Playing Clips in Sequence” on page 247. For more on Ram file 
sequences, see “Writing a Basic Ram File” on page 507. 


Laying Out SMIL Presentations 


As explained in Chapter 12, you can use SMIL to define separate playback 
regions for different parts of a presentation. This lets you lay out two clips 
side-by-side, for example. When embedding a SMIL presentation in a Web 
page, you can define the layout in SMIL or in HTML. Defining the layout in 
SMIL lets you play all the clips together in a single, embedded window. Using 
an HTML layout lets you place clips at different spots on the Web page. 


Note, too, that a SMIL presentation can open clips in secondary, pop-up 
media windows, as well as display HTML pages in RealOne Player’s media 
browser and related info panes. These features work with embedded 
presentations, too. However, because the media browser and related info panes 
are not present with an embedded presentation, all HTML pages meant for 
these panes display in a new window of the viewer’s Web browser. 


For More Information: The section “Linking to HTML Pages” on 
page 371 explains how to open an HTML page through SMIL. 


Defining the Layout with SMIL 


To control the layout by using SMIL, you set up the regions and their relative 
placements in the SMIL file. You then create a Web page playback area large 
enough to accommodate all SMIL regions. The SMIL file then produces the 
same layout when played through the Web page or RealOne Player. For 
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example, if your SMIL file creates a playback area 400 pixels wide by 300 pixels 
high, you define an image window at least as large as this with the <EMBED> or 
<OBJECT> tag, as shown in the following example: 


<EMBED SRC="presentation.rpm” WIDTH=400 HEIGHT=300 NOJAVA=true 
CONTROLS=ImageWindow CONSOLE=one> 


You can then use additional <EMBED> tags linked to the console named one to 
provide RealOne Player controls for the presentation. 


Tip: Typically, your image window is the same size as your 
SMIL root-layout area, which is described in the section “Root- 
Layout Area” on page 267. 


Defining the Layout with HTML 


The second method omits layout information in the SMIL file, defining the 
layout with HTML instead. You could place each clip that plays in a SMIL 
presentation in a separate cell of an HTML table, for example. Each <EMBED> 
or <OBJECT> tag then uses a REGION parameter to define a region name. The 
region each clip plays in is denoted by the region attribute in the SMIL clip 
source tag: 


<textstream src="news.rt” region="newsregion” /> 


Within the HTML page, the <EMBED> tag that plays news.rt would look like 
this: 

<EMBED SRC="presentation.rpm” WIDTH=250 HEIGHT=144 NOJAVA=true 
CONTROLS=ImageWindow REGION=newsregion CONSOLE=one> 


You define similar <EMBED> tags to create other regions for other clips listed in 
the SMIL file. The SRC parameter in each tag lists the same SMIL file. You can 
also use additional <EMBED> or <OBJECT> tags linked to the same console to 
provide RealOne Player controls for the presentation. 


For More Information: The section “Assigning Clips to Regions” 
on page 287 explains the use of region attributes in SMIL clip 
source tags. 
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PRESENTATION DELIVERY 


When you finish building your RealOne Player presentation, you 
place the clips on Helix Universal Server or a Web server for delivery 
to your audience. This chapter explains how to link your Web page 
to your clips and SMIL files. It shows how to write a Ram file, a 
simple text file that launches RealOne Player and gives it the URL to 
your clip or SMIL presentation. 


Understanding Linking and URLs 


Although the process of linking your Web page to your clips is simple, there 
are two types of mistakes that are easy to make: 


1. An incorrect URL can prevent a Web browser or RealOne Player from 


finding a requested file. 


2. An incorrect protocol designation (http://, for example) can keep a clip 
from streaming correctly. 


The following sections provide an overview of the process of linking your Web 
page to streaming clips on a server. The remainder of this chapter then covers 
the various options for delivering your presentation. 


The Ram File 


The most common method of linking your Web page to your clips is through 
a Ram file, which is also called a metafile. This file uses the extension .ram and 
often has just one line that gives the full URL to your streaming clip or SMIL 
presentation. There are several reasons that you use a Ram file rather than 
link your Web page directly to your streaming clips: 


1. The Ram file launches RealOne Player. 


The file extension .ram causes a Web browser to launch RealOne Player to 
play the presentation. RealOne Player might not launch when you link 


503 


RealNetworks Production Guide 


504 


directly to a clip. When you link your Web page directly to a Flash Player 
file (extension .swf), for example, the browser launches Macromedia’s 
Flash Player. If you intend to stream your Flash clip, you need to use a 
Ram file to launch RealOne Player instead. 


2. The Ram file provides an RTSP URL for clips on Helix Universal Server. 


Clips on Helix Universal Server stream over the RTSP protocol, rather 
than HTTP. This means that the URL used to request the clips must start 
with rtsp:// rather than with http://. Because browsers cannot make RTSP 
requests, you link your Web page to a Ram file with an HTTP URL. The 
Ram file then gives RealOne Player the RTSP URL to your presentation. 


For More Information: See the section “The Difference Between 
RTSP and HTTP” on page 505. 


3. The Ram file can pass parameters to RealOne Player. 


Through optional Ram file parameters, you can modify your clip or SMIL 
presentation by, for example, playing it double-size. You can also specify 
HTML pages that display as a clip plays. 


How a Ram File Works 


You can link a Ram file to a Web page with a standard <a href> hypertext link. 
The following actions occur when a viewer clicks this hypertext link to request 
a streaming presentation: 


1. The Web browser requests the Ram file from a Web server or Helix 
Universal Server. 


2. The Ram file extension (.ram or .rpm) causes the Web browser to launch 
RealOne Player. 


3. RealOne Player receives the Ram file and requests the clip or SMIL file 
from the Web server or Helix Universal Server. 


4. When a SMIL file is used, RealOne Player requests the clips based on the 
URLs in the SMIL file. 


The Ram File for Embedded Presentations 


For presentations in which RealOne Player pops up as a separate application, 
you use .ram as the Ram file extension. When you embed a clip or presentation 
in a Web page as described in Chapter 20, however, the Ram file uses the file 
extension .rpm. RealOne Player still plays the presentation, but it does not 
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launch as a separate application. Instead, the browser appears to play the clips. 
Aside for the file extension, there’s no difference between a Ram file for a pop- 
up presentation (.ram), and one for an embedded presentation (.rpm). 


The Ramgen Alternative to Ram Files 


When you stream clips from Helix Universal Server, you have the option of 
using Ramgen, a feature that lets you link your Web page directly to your 
streaming clips without using a Ram file. Ramgen uses a specially configured 
URL that causes the browser to launch RealOne Player and stream clips using 
RTSP. Although not suited for all streaming presentations, Ramgen can 
simplify the process of linking your Web to your clips in many cases. For 
instructions on using Ramgen, see “Using Ramgen for Clips on Helix 
Universal Server” on page 519. 


The Difference Between RTSP and HTTP 


To deliver HTML pages and graphics, a Web server uses HyperText Transport 
Protocol (HTTP), as you can see in Web page URLs that begin with http://. 
HTTP downloads files without regard to timelines, making clips with 
timelines more likely to stall. Although Helix Universal Server can also use 
HTTP, URLs for media clips streamed by Helix Universal Server begin with 
rtsp://, which causes Helix Universal Server to use Real-Time Streaming 
Protocol (RTSP), Internet standard protocol set forth by the Internet 
Engineering Task Force (http://www.ietf.org/). 


Designed specifically for streaming, RTSP enables Helix Universal Server to 
adjust streaming data to keep clips playing smoothly. When two clips play 
side-by-side, for example, RealOne Player communicates with Helix Universal 
Server about each clip’s progress, indicating how much data it needs to keep 
playback synchronized. Helix Universal Server can then adjust the data flow to 
compensate for changing network conditions, reducing low priority data if 
necessary to ensure that crucial data gets through. Communication like this is 
not possible through HTTP. 


Which URLs Use Which Protocol 


When you assemble a RealOne Player presentation, it’s important to 
understand clearly which URLs should use HTTP and which should use 
RTSP: 


+ RTSP in SMIL and Ram files for clips on Helix Universal Server 


505 


RealNetworks Production Guide 


506 


Use rtsp:// in URLs in which RealOne Player requests clips from Helix 
Universal Server. These URLs occur in SMIL files (.smil) and Ram files 
(.ram or .rpm). 


HTTP in SMIL and Ram files for clips on Web servers 


Use http:// in SMIL and Ram file URLs only if the clips are stored on a 
Web server instead of on Helix Universal Server. Because a Web server does 


not use RTSP, you cannot use rtsp:// in a URL to a clip stored on a Web 


Server. 


HTTP in Web pages 


Web page links to a Web server or Helix Universal Server always start with 
http://. Web browsers cannot interpret streaming information sent by 
Helix Universal Server through RTSP. The Web browser can connect to 
Helix Universal Server through HTTP, though, because Helix Universal 
Server also uses HTTP. 


For More Information: For more on SMIL file URLs, see 
“Creating Clip Source Tags” on page 209. 


Directory Paths and URLs 


You typically create your clips and SMIL files on a desktop computer or a 
workstation, then transfer them to a server, whether Helix Universal Server or 
a Web server, for streaming. If a server is on the same local area network (LAN) 
as your computer, you can often just copy the files to the server over the 
network. Otherwise, you can usually transfer files to a server over the Internet 
using FTP (file transfer protocol). 


The Helix Universal Server or Web server administrator can create the content 
directories for you, and also set up features such as password authentication 
and pay-per-view. It’s important to understand that the paths to the clips ona 
server and the URLs used to request the clips are different. For example, a clip 
on Helix Universal Server may reside in the following path on a Windows 
computer running Helix Universal Server: 


C:\Program Files\Real\Helix Server\Content\video1.rm 
But the URL used to request the clip may look like this: 
rtsp://helixserver.example.com/videol.rm 


You'll need the directory path to transfer the clips to the server, and the URL 
to set up the links for requesting the clip. Your Helix Universal Server or Web 
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server can give you the path to the content directories, and tell you the URLs 
to use to request the clips. 


Launching RealOne Player with a Ram File 


A Ram file is a text file with the extension .ram (.rpm for playback in a Web 
page). When a browser receives this file, it launches RealOne Player as a helper 
application. RealOne Player then requests the clips listed in the Ram file. As 
described in “Using Ramgen for Clips on Helix Universal Server” on page 519, 
Helix Universal Server can launch RealOne Player without using a Ram file. 
When doing any of the following, however, you may need to write a Ram file: 


+ Streaming from a Helix Universal Server not set up to use Ramgen. 
- Hosting a RealOne Player presentation on a Web server. 
+ Playing back clips that reside on the viewer’s local computer. 


+ Opening a clip in a specific RealOne Player mode, such as full-screen 
mode. 


Writing a Basic Ram File 


The most basic Ram file has only one line: the full URL to a clip or SMIL file. 
A Ram file can also list multiple URLs to different clips, each URL ona 
separate line. This causes RealOne Player to play those clips in sequence. With 
RealOne Player, a Ram file can also contain multiple URLs to SMIL files and 
even to other Ram files. 


Warning! RealPlayer 8 and earlier cannot play Ram files that 
list other Ram files, or more than one SMIL file. 


> To write a Ram file: 


1. Open any editor or word processor that can save files as plain text. On the 
top line, enter the full URL of the SMIL file or the media clip. Add the full 
URL to each subsequent clip or file on a new line. You may need to verify 
URLs with your Helix Universal Server or Web server administrator. The 
following shows sample URLs to a SMIL file, depending on whether the 
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file resides on Helix Universal Server, a Web server, or the viewer’s local 
computer: 


Helix Universal rtsp://helixserver.example.com/sample1.smil 
Server: 

Web server: http://www.example.com/sample1.smil 
Local: file://sample1.smil 


Warning! Press Enter only to create a new line on which you 
want to enter a new URL. Do not press Enter when typing ina 
long URL. It’s OK if your text editor wraps the URL to a new 
line automatically, though. Only a line break you enter yourself 
will cause an error. 


For More Information: For more information on RTSP URLs, see 
“Linking to Clips on Helix Universal Server” on page 218. 


. For a presentation played back from Helix Universal Server, you can 


support earlier versions of RealPlayer (such as RealPlayer 4 or 5) just as 
Ramgen does with the altplay option. To do this, add the marker --stop-- 
after the RTSP URL and then specify the URL for the older clip just as it 
appeared in your previous Ram file. Here’s an example: 
rtsp://helixserver.example.com:554/media/sample.smil 

--stop-- 

pnm://helixserver.example.com:7070/media/old_sample.rm 

The second URL specifies the older protocol with pnm:// and designates 
Helix Universal Server’s PNA port. When RealOne Player or RealPlayer 
connects, it chooses the URL based on its favored protocol. For this 
reason, you cannot list two URLS that both use the same protocol, 
whether rtsp://, pnm://, or http://. 


. Save the Ram file as plain text with a .ram extension (played in RealOne 


Player) or a .rpm extension (played in a Web browser). 


. Move your Ram file to Helix Universal Server or your Web server. Even if 


all your media clips are on Helix Universal Server, you can place the Ram 
file on your Web server. When the browser receives a Ram file, it turns it 
over to RealOne Player, which uses the URLs in the file to request clips. 
Hence the Ram file and the media clips do not need to reside on the same 
computer. 
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5. For .ram files, link your Web page to the Ram file by using an HTML 
hyperlink such as this: 


<a href="http://www.example.com/media/sample.ram”>click for video</a> 


For .rpm files, incorporate the link URL in the <EMBED> tag as described in 
“Using <EMBED> Tags” on page 483. If the Ram file is on Helix Universal 
Server, the URL must not use the ramgen parameter. 


Adding Comments to a Ram File 


You can add a comment to a Ram file by using a pound sign (#) as the first 
character on a line. The following example shows two lines commented out of 
a Ram file: 


# Two videos and a SMIL presentation 

# streamed from Helix Universal Server. 
rtsp://helixserver.example.com/media/videol.rm 
rtsp://helixserver.example.com/media/video2.rm 
rtsp://helixserver.example.com/media/sample2.smil 


Examples of Linking a Web Page to Clips 


The following sections provide some examples of linking a Web page to clips 
or a SMIL presentation that resides on Helix Universal Server or a Web server. 


Linking to a Single Clip 


Suppose you have a single RealVideo clip called video1.rm. You can simply link 
your Web page to a Ram file (play_video1.ram) that resides in the same 
directory as the Web page: 


<a href= “play_videol.ram”>Play the video!</a> 


The Ram file then gives RealOne Player either the full RTSP URL to the clip 
on Helix Universal Server: 


rtsp://helixserver.example.com/videol.rm 


or the full HTTP URL to the clip on a Web server: 


http://www.example.com/video1.rm 


Linking to an Embedded Clip 


Suppose that you’ve embedded a RealVideo clip called video1.rm in your Web 
page according to the instructions in Chapter 20. You can link to a Ram file 
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(play_video1.rpm) that resides in the same directory as the Web page within the 
<EMBED> tag: 


<EMBED SRC="play_video1.rpm” WIDTH=300 HEIGHT=134> 
The Ram file then gives RealOne Player either the RTSP URL to the clip on 
Helix Universal Server: 


rtsp://helixserver.example.com/videol.rm 


or the HTTP URL to the clip on a Web server: 


http://www.example.com/video1.rm 


Linking to a SMIL Presentation 


Linking to a SMIL file is similar to linking to a clip. However, because a SMIL 
file contains the URLs to clips in the presentation, the SMIL file itself can 
reside on any server. Suppose you have a SMIL file named presentation.smil. 
You can simply link your Web page to a Ram file (play_presentation.ram) that 
resides in the same directory as the Web page: 


<a href= “play_presentation.ram”>Play the video!</a> 

The Ram file should give RealOne Player the full RTSP URL to the SMIL file if 
it resides on Helix Universal Server: 
rtsp://helixserver.example.com/presentation.smil 

or the HTTP URL to the file if it resides on a Web server: 
http://www.example.com/presentation.smil 


The SMIL file itself should contain the full URLs to clips in its source tags, as 
in the following example: 
<video src="rtsp://helixserver.example.com/video1.rm” .../> 


For More Information: See “Writing Clip Source URLs” on page 
215 for more information on SMIL file URLs. 


Passing Parameters Through a Ram File 
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A Ram file provides a simple and convenient way to set parameters that open 
HTML pages in the RealOne Player related info and media browser panes. 
Ram file parameters can also affect the clip itself by shortening its playback 
time, for instance. In the Ram file, separate the first parameter from the clip 
URL with a question mark (?), as shown here: 


URL? parameter=value 
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To set two or more parameters for the same clip, precede the second and all 
subsequent parameters with ampersands (&) instead of question marks: 


URL? parameter=value&parameter=value&parameter=value... 
Note the following about Ram file parameters: 


- Parameter values that contain spaces need to be enclosed in double 
quotation marks. Single values do not require quotation marks, though. 


+ Do not press Enter to create a line break when adding parameters to a clip 
URL. The presentation URL and all parameters must be on a single line. 
You can turn your text editor’s word wrap feature on, though, so that the 
line wraps automatically. 


+ Previous versions of RealPlayer that do not support a specific parameter 
will ignore the parameter and still play the media. 


Tip: Appendix G summarizes the Ram file parameters that the 
following sections describe in detail. 


Opening a URL in an HTML Pane 


For each clip in the Ram file, you can provide the URL to one HTML page that 
opens in the RealOne Player related info pane. You can also provide a URL to 
an HTML page that opens in the media browser pane. This feature is useful 
when you want to supplement a clip with one or two HTML pages, but you 
don’t need all the features provided by SMIL. The following table lists the 
Ram file HTML page parameters. 


Ram File Parameters for Opening an HTML Page 


Parameter and Value Function 
rpcontexturl=URL| Displays the specified URL in the related info pane, or 
_keep keeps the existing related info pane open. Use a fully 


qualified HTTP URL. If testing with a local clip, use the 
full, absolute path to the clip on your computer. 


rpcontextheight=pixels | Sets the pixel height of the related info pane. If no height is 
specified, RealOne Player uses the height of the media clip. 
See “Related Info Pane Sizing” on page 35 for more 
information. 


rpcontextwidth=pixels | Sets the pixel width of the related info pane. If no width is 
specified, a default of 330 pixels is used. 


(Table Page 1 of 2) 
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Ram File Parameters for Opening an HTML Page (continued) 


Parameter and Value 


Function 


rpcontextparams= 
URL_parameters 


Appends parameters to the rpcontexturl URL. HTML page 
parameters are generally separated from the page URL with 
a question mark. In a Ram file, however a question mark 
indicates the start of the Ram file parameters. Hence, if you 
need to append parameters to your related info page URL, 
do so through rpcontextparams. 


rpcontexttime= 
dd:hh:mm:ss.x 


Specifies the time at which the HTML page displays in the 
related info pane, relative to the start of the media clip. 
Only the seconds (ss) field is required, so rpcontexttime=10 
means to open the related info pane 10 seconds after the 
clip starts to play. If no time is specified, the page opens 
when the clip starts to play. Use of start=hh:mm:ss.x with 
the clip does not affect when the HTML page displays. 


rpurl=URL 


Specifies the URL to display in the media browser pane. 
This URL always opens when the clip begins to play. If 
testing with a local clip, use the full, absolute path to the 
clip on your computer. 


rpurlparams= 
URL_parameters 


Appends parameters to the rpurl URL. If you need to add 
parameters to your media browser page URL, do so 
through rpurlparams. 


rpurltarget=_rpbrowser 
|name 


rpvideofillcolor= 
color_value 


Background Color Values 


Sets the target for rpurl as the media browser pane when 
you use _rpbrowser, or as a secondary browsing window if 
you use any other name. Because the default is _rpbrowser, 
you can omit this parameter to use the media browser. 


Specifies a background color for the media playback pane, 
allowing you to match the backgrounds for the media 
playback and related info panes. Black is the default color. 
See below for more about colors. 

(Table Page 2 of 2) 


For rpvideofillcolor, use one of the following: 


- Acolor name, as described in “Using Color Names” on page 553 


- An RGB value, as described in “Specifying RGB Color Values” on page 555 


- Asix-digit hexadecimal value as described in “Defining Hexadecimal 


Color Values” on page 554. 
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With a hexadecimal color value, substitute the escape character %23 for the 
pound sign (#), which, in a Ram file, signifies the start of a comment. For 
example, suppose that you want to match the following hexadecimal color 
used in a related info HTML page: 


<BODY BGCOLOR="#FF5A4E”> 
You would add the following to your Ram file: 
rpvideofillcolor=%23FF5A4E 


Examples of Opening HTML Pages 


Opening a Page in the Related Info Pane 
The following example plays a clip and opens an HTML page in a related info 
pane that is 250 pixels high and 280 pixels wide: 


rtsp://helixserver.example.com/videol.rm?rpcontextheight=250 
&rpcontextwidth=280&rpcontexturl="http://www.example.com/relatedinfo1.html” 


Opening a Page in the Media Browser Pane 
The next example opens an HTML page in the media browser pane when the 
clip begins to play: 


rtsp://helixserver.example.com/video2.rm?rpurl="http://www.example.com/index.html” 


Keeping the Same Context Pane, But Changing Background Colors 

The following sample Ram file plays two clips in sequence. After the first clip 
plays for 5.5 seconds, the Ram parameters open an HTML page in a related 
info pane that is 350 pixels high by 300 pixels wide. The media playback 
pane’s background color is set to rgb(30,60,200). When the second clip plays, 
the same related info pane is kept onscreen, but the media playback pane’s 
background changes to red: 


# First URL that opens a related info pane. 
rtsp://helixserver.example.com/video3.rm?rpcontextheight=350 
&rpcontextwidth=300&rpcontexturl="http://www.example.com/relatedinfo2.html” 
&rpcontexttime=5.5&rpvideofillcolor=rgb(30,60,200) 

# 

# Second URL that keeps the same related info pane, 

# but changes the media playback pane’s background color. 
rtsp://helixserver.example.com/video4.rm?rpcontexturl=_keep 
&rpvideofillcolor=red 
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Tips for Opening HTML URLs 


+ HTML panes do not display when the media plays at full-screen size. 
Therefore, you should not open an HTML page when also using 
screensize=full. 


+ Do not include the URL to an HTML page when embedding a clip or 
SMIL presentation in a Web page through a .rpm file. 


+ To open more than one HTML URL for a clip in the related info or media 
browser pane at any point during the presentation, write a SMIL file that 
includes the HTML URLs in the markup as described in “Linking to 
HTML Pages” on page 371. 


Controlling How a Presentation Initially Displays 


In the Ram file, you can set several parameters that control how RealOne 
Player initially displays a clip or SMIL presentation. You can play a clip at 
double its normal size, for example, play part of a clip, or open the RealOne 
Player at full-screen size. To control these characteristics, add one or more of 
the following parameters to the Ram file URL. 


Ram File Parameters for Setting the Initial Display 


Parameter and Value —- Function 


screensize=double| | Opens the clip or presentation at double its normal size, at 
full|original full-screen size, in which the monitor looks like a televsion set, 
or at its original size, which is the default. 


mode=normal| Opens RealOne Player in one of three modes. In normal mode, 
theater|toolbar which is the default, controls are grouped around the media 
playback pane. In toolbar mode, the controls appear at the 
bottom of the computer screen. In theater mode, controls are 
put in toolbar mode, and the media presentation appears 
centered on a darkened screen. The toolbar and theater modes 
are available only to subscribers of the premium services. 
(Table Page 1 of 2) 
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Ram File Parameters for Setting the Initial Display (continued) 


Parameter and Value —- Function 


start=hh:mm:ss.x Starts the clip at the specified point in its timeline. Only the 
seconds field is required, so start=45 begins the clip at its 45- 
second mark. This parameter shortens the total time the clip 
plays, but it does not delay the clip from starting its playback. 


end=hh:mm:ss.x Ends the clip at the specified point in its timeline. Only the 
seconds field is required. For example, end=3:30 means to end 
the clip when it reaches its internal mark of three minutes and 
thirty seconds. The total time that the clip plays is the end 
time minus the start time. 


(Table Page 2 of 2) 


Examples of Setting a Presentation’s Initial Display 


Opening a Clip in Full-Screen Mode 


The following example opens a SMIL presentation in full-screen mode: 


rtsp://helixserver.example.com/sample1.smil?screensize=full 


Opening a Clip at Normal Size in Toolbar Mode 
The next example opens a RealVideo clip at double its normal size, and sets 
RealOne Player to its toolbar mode: 


rtsp://helixserver.example.com/videol.rm?screensize=double&mode=toolbar 
Playing a Clip Excerpt 
The final example plays a 30-second excerpt from the middle of a clip: 


rtsp://helixserver.example.com/audio1.rm?start=55&end=1:25 


Tips for Setting the Initial Display 


+ HTML panes do not display when the media plays at full-screen size. 
Therefore, you should not open an HTML page when also using 
screensize=full. 


+ RealOne Player may not offer full-screen mode on all operating systems. If 
RealOne Player for a given operating system does not offer full-screen 
mode, it plays the presentation at its normal size. 


- If RealOne Player offers full-screen mode but has not yet played a clip full- 
screen, it may first perform a test of this playback mode. 


+ The double-size and full-screen modes work best for high-speed clips. 
They are not recommended for presentations delivered through modems. 
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+ Always test playback when using double and full-screen modes to ensure 


that the visual quality is acceptable. Some types of clips may not scale well. 


+ In full-screen mode, the viewer can control RealOne Player through a 
contextual menu displayed by right-clicking (on Windows) or holding 


down the mouse button (on Macintosh). 


- Do not use these options when embedding a presentation in a Web page 


through a .rpm file. 


- RealOne Player displays a presentation’s elapsed time in one-second 


increments. You can click the time-elapsed field to display time values to 


1/10th of a second, however. This can help you decide what start and end 


timing values you want to use in a Ram file. 


+ For a SMIL presentation, use clipBegin and clipEnd in the clip source tag, 


rather than start and end in the Ram file, to play an excerpt from a clip. 


For more information, see “Setting Internal Clip Begin and End Times” 


on page 316. 


Overriding Title, Author, and Copyright Information 


A streaming clip often encodes title, author, and copyright information. When 


you encode a RealAudio or RealVideo clip, for example, you can add this 


information to the clip through Helix Producer. Through the Ram file, you 


can override this title, author, and copyright information. These parameters 


are compatible with earlier versions of RealPlayer. 


Parameter and Value 


Title, Author, and Copyright Parameters 


Function 


title="text” 


Specifies the clip title. 


author="text” 


Indicates the clip author. This information displays in the 
Artist field of the clip information panel. 


copyright="text” 


Gives the copyright notice. You can use the HTML code 
&#169; to create the standard copyright symbol. 


For More Information: For information about where this 


information displays in RealOne Player, see “Where Title, 


Author, and Copyright Information Displays” on page 238. 
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Example of Setting Title, Author, and Copyright Information 


The following example sets title, author, and copyright information for a 
video clip: 
rtsp://helixserver.example.com/introvid.rm?title="Introduction to RealOne Player 


Production" &author="RealNetworks, Inc."&copyright="&#169;2001, 
RealNetworks, Inc." 


Setting Clip Information 


The clipinfo parameter is new with RealOne Player, and is ignored by earlier 
RealPlayers. Geared for online music, it allows you to encode information 
such as the artist name, album, genre, and so on, which displays when the 
viewer chooses the View>Clip>Clip Info command, or presses Ctrl+i. The 
clipinfo parameter uses one long value surrounded by double quotation 
marks. Within the quotes, you separate the subvalues with vertical lines, or 
“pipes,” as shown here: 


clipinfo="name=value|name=value|name=value...” 


The following table describes the name and value pairs that you can use with 
clipinfo. You can use any set of values, and list them in any order. Most text 
values can be over 100 characters long. 


Clipinfo Parameter Values 


Name and Value Function 

title=text Gives the clip title. 

artist name=text Indicates the artist name. 

album name=text Gives the album name. If you specify an album name and do 


not also display an HTML page in the related info pane, 
RealOne Player displays in that pane a standard page that lists 
the artist, album, year, and genre values. The viewer can hide 
this information, though, with Tools>Album Info>Hide. 


genre=text Indicates the clip genre, such as Rock or Jazz. 
copyright=text Gives the copyright notice. 

year=text Indicates the year the content was released. 
cdnum=number Supplies the CD track number. 
comments=text Provides any additional comments. 
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Note: Do not use the title, author, and copyright parameters 
described in “Overriding Title, Author, and Copyright 
Information” on page 516 along with clipinfo. 


Using Text Escape Characters 


To use certain text characters in a value for the clipinfo parameter, you must 
use the character’s corresponding escape code. This is because certain 
characters represent syntax components. A pipe (|) represents the start of a 
new value, for example, so to use a pipe within a value, you must use the 
escape code %7C. The following table lists some common text characters that 
you can add through escape codes. 


Text Character Escape Codes 


Name Character Escape Code 
ampersand & 02.6 
apostrophe ‘ %o27 
backslash \ %5C 
carat * %5E 
double quote a %o22 
greater than sign > %3E 
left bracket [ %5B 
less than sign < %3C 
percent sign Fo 25 
pipe | %7C 
pound sign # 23 
right bracket ] %5D 


You can enter other common text characters, such as commas, periods, and 
colons directly into clipinfo parameter. Conversely, you can display any text 
character, including letters and numbers, by using an escape code that starts 
with % followed by the character’s ASCII hexadecimal value. You can create an 
asterisk (*) with the escape code %2A, for example. 


For More Information: Visit http://www.asciitable.com for a 
full list of ASCII codes. 


Example of Setting Clip Information 


This example sets the clipinfo parameter for an audio clip: 
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rtsp://helixserver.example.com/song1.rm?clipinfo="title=Artist of the Year| 
artist name=Your Name Here|album name=My Debut|genre=Rock| 
copyright=2001|year=2001|comments=This one really knows how to rock!" 


The following figure illustrates how this information appears in the clip 
information panel (Ctrl+i). 


Clip Information 


File Credits 


Title: Artist of the Year 
Artist: ‘Your Name Here 
Album: My Debut 


Genre: Rock 


Copyright: ©2001 RealNetworks, Inc. 
Length: 0:10 Year: 2001 CD Track & 
Comments: This one really knows how to rock! 


Using Ramgen for Clips on Helix Universal Server 


With Helix Universal Server, you can use Ramgen to launch RealOne Player 
automatically, eliminating the need to write a separate Ram file. Your Web 
page URL simply points to your media clip or SMIL file on Helix Universal 
Server and includes a ramgen parameter. If your Helix Universal Server does 
not use Ramgen, you can write a Ram file as explained in “Launching RealOne 
Player with a Ram File” on page 507. A Ram file also enables you to use some 
RealOne Player features, such as playing a clip at double or full-screen size. 


The following illustration shows the process of requesting a presentation 
through Ramgen. This example uses a SMIL file that coordinates multiple 
clips, but you can also link to a single clip directly without using SMIL. 
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Requesting a Presentation from Helix Universal Server Using Ramgen 


Player ( 1 ) 


Server and 
Web SMIL File 
Browser 
CE ../ramgen/... 
|: 3 Pe ® 
aN — 
SMIL 
File 


Media Clips 


Player 


with SMIL File 


1. Using HTTP, the Web browser requests the SMIL file from Helix Universal 
Server. The URL includes a /ramgen/ parameter that invokes Ramgen. 


2. Helix Universal Server’s response causes the Web browser to launch 
RealOne Player as a helper application and to give it the URL to the SMIL 
file. 


3. RealOne Player requests the SMIL file from Helix Universal Server using 
RTSP. 


4. With the information in the SMIL file, RealOne Player requests and 
receives the streaming media clips. 


Linking Your Web Page to Helix Universal Server Using Ramgen 


With your clips on Helix Universal Server, link your Web page to the SMIL file 
by using an HTML hypertext link that looks like the following: 


<a href="http://helixserver.example.com:8080/ramgen/media/sample.smil”>...</a> 
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If the presentation plays back directly in the Web page, the URL occurs within 
an <EMBED> tag and looks like this: 


SRC="http://helixserver.example.com:8080/ramgen/media/sample.smil?embed” 


In these examples, the /ramgen/ parameter causes the Web browser to launch 
RealOne Player without the use of a separate Ram file. This parameter 
designates a virtual directory in Helix Universal Server, and can be followed in 
the URL by actual directory listings. The following table describes the 
components of these URLs. Contact your Helix Universal Server administrator 
to get the actual Helix Universal Server address, HTTP port, and directory 


structure. 
URL Components in a Web Page Link to Helix Universal Server 
URL Component Function 
http:// This causes the browser to contact Helix Universal Server 


through HTTP. (Web browsers do not use RTSP.) 


helixserver.example.com | This address varies for each Helix Universal Server. It 
typically uses an identifier such as helixserver instead of 
www. It may also use a numeric TCP/IP address, such as 
204.71.154.5. 


78080 This is the port Helix Universal Server uses for HTTP 
connections. Separate the port and address with a colon. 
You can leave the port number out if Helix Universal 
Server uses port 80 for HTTP connections. Include the 
port number if Helix Universal Server uses any port other 
than 80 for HTTP. 


/ramgen/ This parameter launches RealOne Player without the use 
of a separate Ram file. 


/media/ Following /ramgen/, the URL may list other directories, 
depending on where the clip resides on Helix Universal 
Server. 


sample.smil This is the SMIL file for your presentation. If you have 


only one clip to stream, you can link directly to that clip 
instead of to a SMIL file. 


?altplay=file. ext This Ramgen option specifies an alternate presentation 
created for earlier versions of RealPlayer. See “Listing 
Alternative Presentations with Ramgen” on page 522. 


?embed This Ramgen option embeds the presentation in a Web 
page. See Chapter 20 for complete information on Web 
page playback. 
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Listing Alternative Presentations with Ramgen 


With altplay, you can use a single link to stream new clips to RealOne Player, 
while streaming older clips to earlier versions of RealPlayer. Suppose that you 
have a RealVideo 5 clip and a RealVideo 9 clip laid out using SMIL. You link to 
the SMIL file using Ramgen as described in the preceding section, and you 
include altplay to list the older clip: 


<a href="http://.../ramgen/media/sample.smil?altplay=old_sample.rm”> 


This link instructs Helix Universal Server to point RealPlayer G2 or later to 
sample.smil. Earlier versions of RealPlayer receive the URL to old_sample.rm. 
Helix Universal Server uses the streaming protocol appropriate for each 
RealPlayer version, whether RTSP or the older PNA. Note that altplay specifies 
the clip, not a Ram file. Because of this, the older clip must reside in the same 
directory as the new content. 


Combining Ramgen Options 


The question mark operator (?) separates Ramgen options from the main 
URL. To use multiple Ramgen options, you use a question mark before the 
first option and separate the remaining options with ampersands (&). The 
order of options does not matter. For example, the following link uses altplay 
and embed: 


<a href="http://.../ramgen/media/sample.smil?embed&altplay=old_sample.rm’> 
You can use the ? operator to include earlier Ram file options when using 
altplay. If your Ram file URL for a RealVideo 5 clip specified an end time, for 


example, include that option in the Ramgen URL after altplay. The following 
example shows an end time set for old_sample.rm: 


<a href="http://.../ramgen/media/sample.smil?altplay=old_sample.rm&end=7:45"> 


Hosting Clips on a Web Server 
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If you do not have access to Helix Universal Server, you can host your 
presentation on a Web server. Although not as robust as Helix Universal Server 
streaming, Web server playback provides a reasonable method for delivering 
simple presentations to a small number of viewers. The following sections 
describe features available with Web servers, and discuss limitations you may 
encounter when using a Web server instead of Helix Universal Server. 
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Web Server MIME Types 


To download a RealOne Player presentation from a Web server, you must 
configure the server with the MIME types listed in the following table. The 
Web server administrator can configure the MIME types properly. 


Web Server MIME Types for RealOne Player Files 


File Type Extension MIME Type 

Ram .ram audio/x-pn-realaudio 
embedded Ram |.rpm audio/x-pn-realaudio-plugin 
SMIL .smiland.smi | application/smil 

RealAudio ta audio/x-pn-realaudio 
RealVideo .rm application/x-pn-realmedia 
Flash Swf application/x-shockwave-flash 
RealPix .rp image/vnd.rn-realpix 
RealText ert text/vnd.rn-realtext 


GZIP Encoding for Large Text Files 


Some Web servers support GZIP encoding for delivering large text files, 
cutting download time for these files 30% or more. RealPlayer 8 and RealOne 
Player on any operating system can decode a GZIP file automatically. This 
helps speed the playback of presentations that include large text files. Refer to 
your Web server documentation for information about creating GZIP files 
from text files. 


Tips for Using GZIP 
+ Use GZIP only for text files such as SMIL (.smil), RealText (.rt), and 
RealPix (.rp). It’s generally not necessary to use GZIP with Ram files (.ram 
and .rpm). 
- Using GZIP is never required, and the utility generally provides benefits 
only when streaming text files that are larger than a few Kilobytes in size. 


- Do not use GZIP with streaming media clips, such as RealVideo (.rm) or 
Flash (.swf), or graphics files such as JPEG, GIF, or PNG. These clips are 
already compressed. Plus, RealOne Player cannot decode a GZIP file until 
it receives the entire file. Hence, GZIP files download rather than stream. 
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- You do not need to include the .gz extension, which the GZIP utility adds 
to files, in your Ram or SMIL file URLs. Use each file’s standard 
extension. The Web server and RealOne Player locate the GZIP file 
automatically, as long as your URL specifies the correct directory and file 
name. 


- You can use GZIP encoding with either static or dynamically generated 
text files. 


Limitations on Web Server Playback 


Because Web servers are not designed to manage bandwidth or keep multiple 
clips synchronized, presentations delivered by a Web server are more likely to 
stall than when streamed by Helix Universal Server. To ensure that a 
presentation hosted by a Web server plays as smoothly as possible, observe the 
following points. 


No SureStream Clips Encoded for Multiple Bandwidths 


A Web server cannot send just one stream from a SureStream clip encoded for 
several bandwidths. Instead, it downloads the entire clip, causing a very high 
preroll. You must therefore encode each RealAudio or RealVideo clip for just 
one bandwidth. When using Helix Producer, select the option for Web server 
playback and choose your target audience. To support multiple bandwidths, 
encode separate clips for various bandwidths, and use SMIL to let RealOne 
Player choose which clip to play. 


For More Information: For more on using SMIL to list clip 
choices, see “Switching Between Bandwidth Choices” on page 
446. 


No Secure RealAudio and RealVideo Clips 


When you encode RealAudio and RealVideo clips with Helix Producer, you 
have an option to prevent RealOne Player users from recording the streamed 
clips to their computers. This feature works only when Helix Universal Server 
streams the clips. When a Web server delivers the clips, users still cannot 
record the clips through RealOne Player, but their Web browsers will cache the 
clips. Additionally, any user can click on your Web page hypertext links and 
use Save as... commands to download the clips from the Web server. 
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Limited Ability to Keep Parallel Clips Synchronized 


A Web server does not consider clip timelines when downloading data. Nor 
does it receive feedback from RealOne Player about the presentation’s 
progress. Web server playback therefore makes it harder for RealOne Player to 
keep clips synchronized. A presentation that plays large clips in parallel may 
stall when the RealOne Player connection has little bandwidth to spare. 


No Way to Set Image Streaming Speeds 


As the section “Setting a Clip’s Streaming Speed” on page 210 explains, you 
can set an image clip’s streaming speed with a <param/> tag when you use 
Helix Universal Server. This SMIL attribute has no effect on presentations 
delivered with a Web server, however. A Web server will download the image as 
quickly as possible, which may interfere with other clips that display at the 
same time. 


RealPix Presentations Require Clip Size Information 


Helix Universal Server determines when to stream each RealPix image based 
on the image’s place in the presentation timeline. Because a Web server cannot 
do this, you must indicate each image’s file size in the RealPix markup. This 
enables RealOne Player to calculate when to request an image from the Web 
server so that all image data has arrived by the time the image displays. If the 
file size information is missing, RealOne Player requests all images when the 
presentation starts, causing a high preroll. For more information, see 
“Indicating the Image Size for Web Servers” on page 166. 


SMIL File Optional 


When delivering a single clip or a few clips played in sequence, you do not need 
a SMIL file. Instead, you can simply list the clips in order when writing your 
Ram file, as described in “Launching RealOne Player with a Ram File” on page 
507. However, you can also have your Ram file specify a SMIL file that lists the 
clip locations, creates a layout, times the presentation, and so on. 


Note: RealNetworks does not recommend using long or 
complex SMIL files when delivering presentations with a Web 
server. Limit your SMIL file to a few clips played in sequence or 
in parallel. 
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SMIL Internal Timing Commands Do Not Work 


Although you can use SMIL to lay out and time your presentation, you should 
not use the clipBegin and clipEnd attributes. A Web server cannot begin to 
download a clip at a certain point in its timeline. With clipBegin="5min", for 
example, RealOne Player must wait until it has received the first 5 minutes of 
clip data before it can play the clip. This results in an unacceptably long wait. 


For More Information: “Setting Internal Clip Begin and End 
Times” on page 316 describes these SMIL commands. 


No Presentation Seeking 


Because a Web server cannot jump to a new position in a clip’s timeline, the 
RealOne Player position slider cannot fast-forward the clip. If the viewer 
moves the slider forward, playback pauses as the clip continues to download 
at its normal rate. RealOne Player resumes playback once the clip data reaches 
the specified timeline position. 


No RTSP URLs 


Because Web servers do not support RTSP, all URLs in presentations hosted 
by Web servers should begin with http://. This includes all URLs in a SMIL file 
or Ram file. 


No Live Broadcasting 


Live broadcasting is not possible because Web servers can download only clips 
that are stored on disk. 


Testin g Your Presentation 


Use the following guidelines to make sure your presentation works well and 
reaches its target audience: 


- Test your presentation in “real world” conditions. If you target 56 Kbps 
connections, for example, request the presentation over a 56 Kbps 
modem. 


+ Check that the presentation has a preroll (initial buffering) under 15 
seconds. After preroll, the presentation should not rebuffer under normal 
network conditions. 


For More Information: See “Buffering” on page 46. 
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+ Verify that video and audio quality is acceptable. 


- Fora multiclip presentation, verify that clips stay synchronized. Ensure 
that no stalling occurs because of too many clips playing at the same time, 
or a single clip requiring too much bandwidth. Make sure that clips 
introduced during a presentation in progress do not stall playback by 
requiring too much buffering when they start. 


+ Make sure that your presentation works well for an “average” CPU for 
your audience. For general Web delivery, test playback on both Pentium 
and Power Macintosh computers with clock speeds around 300 MHz. 


Tip: If your presentation is CPU-intensive because it uses 
complex Flash animation or high-bandwidth video, for 
example, note this in your Web page. 


+ When streaming RealAudio clips, ensure that sound quality is acceptable. 
You may need to experiment with RealAudio codecs to find the best 
balance between clip bandwidth use and sound quality. 


+ Test all hypertext links and interactive functions. 


+ When embedding a presentation in a Web page, verify that the image 
window has the correct location and controls. 


Advertising on RealGuide 


Every day, thousands of people visit RealGuide, RealNetworks’ online guide 
for streaming media sites and live events (http://realguide.real.com). If you 
regularly host streaming media presentations of interest to the public, or if 
you have a live event you want to advertise, you can submit your listing to 
RealNetworks. Simply complete the following online form to list your site or 


live event: 

- http://realguide.real.com/info/?page=submit 
In the form, you provide the site or event name, the URL, a short description, 
and the name of a contact person. A RealGuide staff member then verifies 
your site or event before including it on RealGuide. (RealNetworks reserves 
the right to edit or refuse submissions.) For live events, please submit your 
request at least one business day in advance. If you have questions or need to 
change a listing, please contact RealGuide from this Web page: 


- http://realguide.real.com/info/?page=fbform 
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Using RealNetworks Logos 


When you create RealOne Player content, RealNetworks encourages you to 
add RealOne Player logos to your Web page. You can provide a RealOne Player 
download link button, for example, so that users can get RealOne Player from 
RealNetworks’ Web site and view your content. You can read RealNetworks’ 
trademark policies and get RealOne Player logos at the following address: 


http://www.realnetworks.com/company/logos/index.html 
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BASIC INFORMATION 


Whether you’re a novice ora professional, these appendixes will 
help you as you build your presentation. Appendix A takes up 
basic questions beginning users often ask. Once you become 
more familiar with RealOne Player, Appendix B will point you to 
areas of this guide that address specific production issues. 
Appendix C explains color values used with markup such as 
SMIL, RealText, and RealPix. 


PART 


IX 


APPENDIX 


A 


BASIC QUESTIONS 


This appendix, provided for the beginning streaming media creator, 
answers often-asked questions about producing clips for RealOne 
Player. It also provides URLs for Web sites where you can find tools 
and helpful information about developing streaming media 


presentations. 


Playing Media with RealOne Player 


RealOne Player plays the media clips that you create. It can also display HTML 
pages that accompany your media presentation. You can download RealOne 
Player from http://www.real.com. See “Step 2: Learn the RealOne Player 
Interface” on page 29 for an introduction to the RealOne Player interface. 


Is a subscription required to view media with RealOne Player? 


No. RealOne Player includes a subscription service that provides premium 
media content and music. But RealOne Player is designed to be a general- 
purpose media player for any type of free or paid media content. 


Must a presentation played in RealOne Player include HTML pages? 


No. RealOne Player can display HTML pages along with media, a combination 
that greatly enhances the viewing experience. You can also stream media 
alone, though, without displaying HTML pages along with your clips. 


What HTML page technologies does RealOne Player support? 


On Microsoft Windows, RealOne Player uses the existing version of Internet 
Explorer. Because Internet Explorer 4 is the earliest version that functions 
with RealOne Player, writing HTML content that can play in this browser 
guarantees access to the widest possible audience. This supported set of 
technologies includes Javascript 1.2 and Cascading Style Sheets 1 (CSS1). 
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Can | embed streaming media directly in a Web page? 


Yes. You can still use RealOne Player to embed media clips directly into any 
Web page, as described in Chapter 20. However, the native RealOne Player 
interface provides an easier way to coordinate media and HTML pages, 
eliminating the cumbersome markup required to embed a presentation. 


How can | protect copyrights on media? 


RealNetworks provides an extensive Media Commerce Suite that allows you to 
protect copyrights for valuable media assets. You can learn more about this 
suite from the following Web page: 


http://www.realnetworks.com/products/commerce/index.html 


Creating Streaming Clips 


Helix Producer is the basic tool you use to create clips. Both the Helix Producer 
User’s Guide and the product’s online help guide you through the encoding 
process. This production guide provides background information and tips on 
creating high-quality streaming media. 


How do | make streaming audio and video clips? 


You start with an audio or video source file in a digitized format on your 
computer. You then select the file and set encoding options. The encoding 
process creates a new streaming clip, leaving the source file unchanged. 


Can | encode RealVideo directly from a video camera? 


Yes. Helix Producer accepts live video input from a camera and live audio 
input from a microphone. The camera and microphone connect to an 
audio/video capture card on your computer. Helix Producer’s then lets you 
select the live input as the source. In this case, you go directly from live input 
to encoded clip without creating a digitized source file. 


How do | ensure the best quality for streaming clips? 


Quality starts at the source. You need high-quality video and audio input for 
Helix Producer to create high-quality streaming clips. Chapter 3 and Chapter 
4 include tips on producing good audio and video, respectively. If you are new 
to media production, learn your editing hardware and software thoroughly, 
paying close attention to the manufacturers’ recommendations for producing 


high-quality media files. 
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What other clips can | stream? 
In addition to audio and video, RealOne Player can play the following types of 
clips: 
+ Macromedia Flash animation 
+ GIF, JPEG, and PNG images 
+ RealPix clips for streaming slideshows 


+ RealText clips for streaming text 


Getting Production Tools 


To produce streaming media clips, you need audio and video production tools 
as well as Helix Producer to handle the encoding. 


What audio and video editing tools can | use? 


You can use any hardware or software designed for capturing and editing 
audio or video. The digitized output must be in a format that Helix Producer 
accepts, however. Some video editing programs save digitized video ina 
proprietary format that Helix Producer cannot read. However, these programs 
typically let you export the video to a common format that Helix Producer 
accepts, such as AVI, QuickTime, or MPEG. 


Tip: Check http://www.real.com/accessories/index.html for 
hardware and software tools that can help you with capturing 
and editing audio or video. 


What digitized audio and video formats does Helix Producer accept as input? 


Helix Producer accepts many common audio and video formats. These may 
vary by operating system, though. Helix Producer on Macintosh accepts the 
formats widely used on the Macintosh, such as QuickTime, whereas Helix 
Producer on Windows or Unix supports the formats widely used on those 
operating systems. Check the Helix Producer manual for your operating 
system for a list of accepted formats. Information is also available at the 
following Web page: 


http://www.realnetworks.com/products/producer/features.html 
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Where can | get Helix Producer? 


RealNetworks makes versions of Helix Producer for Windows, Macintosh, and 
Linux. You can download the free version or purchase Helix Producer Plus at 
RealNetworks’ Web site: 


http://www.realnetworks.com/products/producer/index.html 


How do | create a streaming slideshow from still images? 


Using RealSlideshow’s graphical interface, you can create streaming RealPix 
presentations from still images. You can even add a soundtrack, or record a 
narration for each image. You can download RealSlideshow from this Web 
address: 


http://www.realnetworks.com/products/slideshow/index.html 


You can also create RealPix presentations by hand with the RealPix markup 
language, which is described in Chapter 7. 


How do | create streaming Flash animation? 


You create animation with Macromedia Flash. You can develop animations 
with Flash 2, 3, or 4. Chapter 5 provides tips for making Flash animation 
stream well to RealOne Player. It doesn’t explain how to create Flash 
animations, however. You can learn more about Flash from Macromedia’s 
Web site: 


http://www.macromedia.com/software/flash/ 


Using SureStream 
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SureStream provides advanced streaming technology for RealOne Player. For 
more information about SureStream, read “SureStream RealAudio and 
RealVideo” on page 50. 


What is SureStream? 


SureStream is a technology that lets a single RealAudio or RealVideo clip 
stream at different bit rates. It does this by bundling into a single clip multiple 
streams, each of which runs at a different bit rate. You can make a SureStream 
clip that streams at either 28.8 Kbps or 56 Kbps, for example. When users 
request the clip, they automatically receive the stream that best matches their 
RealOne Player connection speed. 


APPENDIX A: Basic Questions 


How do | make a SureStream clip? 


Using Helix Producer, you can choose to use SureStream when you encode 
audio or video input. The number of SureStream streams you can encode in 
the clip depends on the type of Helix Producer you use. Helix Producer Basic 
encodes two speeds per clip, whereas Helix Producer Plus encodes up to eight 


speeds per clip. 


Can | use SureStream with a Web server? 


No. A SureStream clip has several streams encoded in a single clip. Unlike 
Helix Universal Server, a Web server cannot extract a specific stream to send to 
RealOne Player. If you plan to deliver clips from a Web server, you need to set 
Helix Producer to use single-rate encoding. 


Writing SMIL Files 


Chapter 8 explains the basics of SMIL. Appendix B explains how to do some 
common tasks with SMIL. Appendix D provides a SMIL reference you can use 
once you are comfortable with SMIL. 


What is SMIL? 


Pronounced “smile,” SMIL stands for “Synchronized Multimedia Integration 
Language.” It is an industry-standard markup language used to lay out and 
time streaming media presentations. SMIL works for RealOne Player the way 
HTML works for a Web browser. 


Is it necessary to use SMIL? 


Not always. When you want to stream just one clip, such as a single RealVideo 
clip, you don’t need to use SMIL. You just link your Web page to the clip 
through a Ram file. For more information, see “What is a Ram file?” on page 
537. 


When should | use SMIL? 


When you stream multiple clips, SMIL gives you the means to lay out the 
presentation and time its clips. It also provides other features, such as letting 
you create hyperlinks that display HTML pages, or that start new media 
presentations. For a rundown of basic SMIL features, see “Understanding 
SMIL” on page 191. 
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How do | write SMIL? 


SMIL is a simple markup language that you can write with a word processor 
or text editor. Some software tools (RealSlideshow, for example) create SMIL 
files automatically. 


What’s the difference between SMIL 1.0 and SMIL 2.0? 


As the numbers suggest SMIL 2.0 is an enhancement to SMIL 1.0, which was 
introduced in 1998. SMIL 2.0 greatly expands the capabilities of SMIL 1.0. 
Because it is newer than SMIL 1.0, though, not every media player that 
supports SMIL 1.0 can handle SMIL 2.0. RealOne Player can handle both 
SMIL 2.0 and SMIL 1.0. RealPlayer G2, RealPlayer 7, and RealPlayer 8 can read 
only SMIL 1.0 files, however. 


Streaming Clips 


Helix Universal Server streams the clips created by Helix Producer. You can 
stream clips yourself with Helix Universal Server, through a service provider 
that has Helix Universal Server available, or, in some cases, from a Web server. 


Do | need to install Helix Universal Server on my desktop computer? 


Not necessarily. To run Helix Universal Server, you need a computer connected 
to an intranet or one that has a direct presence on the Internet. You cannot 
run Helix Universal Server if you use an Internet service provider (ISP) to 
connect to the Internet. If you use an ISP, check whether they have Helix 
Universal Server and whether they can host your streaming presentations for 
you. 


What operating systems does Helix Universal Server run on? 


Helix Universal Server runs on Windows NT/2000 and many Unix platforms, 
including Linux. For a list of available platforms, visit RealNetworks’ technical 
support Web site at http://service.real.com. 


Where do | get Helix Universal Server? 


Helix Universal Server is available on the RealNetworks Web site at 
http://www.realnetworks.com/products/media_delivery.html. Helix 
Universal Server Basic is free. 
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Can | stream clips from a Web server instead of Helix Universal Server? 


Sometimes. A Web server can deliver many types of clips, including RealAudio 
and RealVideo. There are limits to Web server delivery, however. If you plan to 
use a Web server for clip delivery, read “Limitations on Web Server Playback” 
on page 524 first. 


What is a Ram file? 


A Ram file, also called a metafile, is a simple text file with the extension .ram. It 
typically consists of just one line: the URL to a streaming presentation. Your 
Web page does not link directly to your presentation. Instead, it links to the 
Ram file, which ensures that RealOne Player launches. RealOne Player then 
uses the URL in the Ram file to request the presentation. “Launching RealOne 
Player with a Ram File” on page 507 explains how to write a Ram file. 


Tip: When you stream clips with Helix Universal Server, you 
can eliminate the Ram file by using the Ramgen utility. For 
more information, see “Using Ramgen for Clips on Helix 
Universal Server” on page 519. 


If | use SMIL, do | need a Ram file? 


Yes. The SMIL file lists the URLs for clips. The Ram file supplies RealOne 
Player with the URL to the SMIL file (or to your streaming clip, if you’re not 
using SMIL). The Ram file is always necessary because its .ram extension 
launches RealOne Player. 


Why does Helix Universal Server use RTSP rather than HTTP? 


Web servers use HTTP to deliver Web pages and graphics. HTTP is designed to 
download small files quickly and efficiently. It is not suited for streaming large 
media clips, though. RTSP, which stands for “RealTime Streaming Protocol,” 
is an industry-standard protocol that overcomes the deficiencies of HTTP for 
streaming media. RTSP enables Helix Universal Server and RealOne Player to 
stream long clips and compensate for changing network conditions. 


How do | stream clips with RTSP? 


When a clip resides on Helix Universal Server, make sure that the URL used to 
request it starts with rtsp:// rather than http://. An RTSP URL must be in a 
file read by RealOne Player, such as a Ram file or a SMIL file. It cannot be in 
an HTML page hyperlink, because a Web browser does not know how to make 
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an RTSP request. For more on this, see “The Difference Between RTSP and 
HTTP” on page SOS. 


Broadcasting 


For full information about broadcasting media, see Helix Producer User’s Guide 
and Helix Universal Server Administration Guide. 


What do | need for broadcasting over a network? 
You need the following: 


- An audio or video capture card on your computer, to digitize the input 
from a microphone or camera. 


+ Helix Producer on the same computer as the capture card, to encode the 
output in a streaming format and send the stream to Helix Universal 
Server. 


« Helix Universal Server, to broadcast the stream to one or more RealOne 
Players. Helix Universal Server typically does not run on the same 
computer as Helix Producer. 


Can | broadcast through my ISP? 


Possibly. If you connect to the Internet through an ISP, you may be able to 
broadcast streaming media, provided that your ISP has Helix Universal Server 
available and offers broadcasting services. To do this, you will need a fast 
Internet connection to your ISP. You cannot broadcast through an ISP by 
running Helix Universal Server on your desktop computer. 


Can | use SureStream in a broadcast? 


Yes. Using SureStream is recommended because it ensures that users 
connecting at different speeds will each receive the best possible stream. You 
need to make sure, however, that the computer running Helix Producer has 
enough power to encode all the SureStream streams at the same time. Check 
Helix Producer’s manual or online help for system requirements, and perform 
a trial run before streaming the actual broadcast. 


Can | broadcast with a Web server instead of Helix Universal Server? 


No. You need Helix Universal Server to broadcast streaming presentations. 
Web servers are designed to serve HTML pages and graphics to different users 
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at different times. They are not designed to broadcast the same presentation 
to multiple users simultaneously. 


Does a broadcast have to be live? 


No. “Broadcasting” means to send out a stream that more than one RealOne 
Player user can view at the same time. The broadcast can be live, meaning that 
the input originates from a microphone or video camera. Or it can be 
prerecorded, meaning that it originates from a digitized clip prepared in 
advance. If it’s prerecorded, you don’t need to use Helix Producer during the 
broadcast. You just put the clip on Helix Universal Server and then set up 
Helix Universal Server to broadcast the clip as a simulated live event. 


Can | use SMIL with a broadcast? 


Yes. You can use SMIL to include ads with the broadcast, or deliver static clips 
alongside the broadcast. In the SMIL file, you simply treat the broadcast as a 
static clip. The only difference is that you use a special URL created by the 
Helix Universal Server administrator that identifies the resource as a 
broadcast rather than a clip. 


How many people can | reach with a broadcast? 


That depends entirely on your Helix Universal Server and the network 
bandwidth it has available. Each Helix Universal Server can broadcast to a 
specific number of RealOne Players, as defined in its license agreement. For 
large broadcasts, you can use a network of Helix Universal Servers to reach 
thousands of RealOne Players. 


Can RealNetworks broadcast clips for me? 


Yes. Real Broadcast Network (RBN) offers a wide range of services for hosting 
broadcasts. Learn more about RBN at: 


http://www.realnetworks.com/products/rbn/index.html 


Getting Technical Support 


RealNetworks offers a range of technical support features and 
documentation. 
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How do | get technical support from RealNetworks? 


RealNetworks Technical Support operates an extensive Web site at 
http://service.real.com. The site includes answers to frequently asked 
questions, a documentation library, and a searchable knowledge base. To place 
a service call with Technical Support, fill out the e-mail form at the following 
Web page: 

http://customerrelations.real.com/scripts/rnforms 
/contact_tech_service.asp 


Where can | find additional documentation? 


RealNetworks Technical Support maintains a documentation library at 
http://service.real.com/help/library/index.html. Most documents are 
available as bundled HTML archives that you can download, uncompress, and 
read with a Web browser. Many documents are also available in PDF format, 
which is suitable for printing. To read PDF files, you need Adobe’s Acrobat 
Reader, which is available from Adobe’s Web site: 


http://www.adobe.com/products/acrobat/readstep.html 


Where should | go for the latest information? 


The RealNetworks Resources area is the main information site for content 
authors and software developers working with RealNetworks products. You 
can find it at the following Web address: 


http://www.realnetworks.com/resources/index.html 


APPENDIX 


B 


PRODUCTION TASKS 


Intended for beginning and intermediate users, this appendix 
addresses specific production questions by referring you to the 
appropriate section in this guide. If you have questions about a 
specific tag or attribute, you may find later appendixes more 


helpful. 


Streaming Media Concepts 


Chapter 2 introduces you to basic concepts and techniques for producing 
streaming media presentations. 


Streaming Media Concepts 


Question Answer 
“How do RealOne Player's three playback panes interact?) —=—=—=S*«S~— ge 
What can I use RealOne Player’s related info pane to do? page 34 
What sets the related info pane’s height and width? page 35 
How do I use my streaming clips to open HTML pages? page 37 
How do I use my HTML pages to control my clips? page 38 
Which types of streaming clips can RealOne Player play? page 39 
What does RealOne Player’s autoupdate feature do? page 43 
How do I ensure backwards compatibility with earlier RealPlayers? page 44 
Does RealOne Player cache my copyrighted clips? page 45 
How do I reach audiences that have different connection speeds? page 45 
How much data can I stream to a modem or a fast connection? page 47 
What are buffering and preroll? page 46 
How do I plan my presentation’s timeline? page 52 
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RealAudio Clips 


Refer to Chapter 3 to learn about the RealAudio streaming format. Your user’s 
guide or online help for Helix Producer explains how to use that tool to 
encode RealAudio clips. 


RealAudio Clips 


Question Answer 
What is “lossy” compression? page S9 
How much bandwidth does RealAudio use? page 60 
What is a codec? page 60 
When should I use SureStream RealAudio? page 50 
What is the best sampling rate for an audio clip converted to RealAudio? | page 61 
Does RealAudio offer stereo encoding? page 63 
How do I get the best quality sound? page 67 
What media should I use to record audio that I plan to stream? page 67 
What sampling rates can I use for audio input? page 69 
How do I optimize my source audio? page 69 


What uncompressed audio file formats can I turn into RealAudio clips? | page 71 


RealVideo Clips 


Chapter 4 explains RealVideo characteristics. See the user’s guide or online 
help for Helix Producer for instructions on encoding RealVideo clips. 


RealVideo Clips 


Question Answer 

How does a RealVideo clip encode the video’s soundtrack? page 73 
How many frames per second does a RealVideo clip display? page 75 
What frame rate should I use when I capture my video source? page 84 
Can I deliver high frame rates to computers with slow processors? page 80 


What width and height dimensions should I use for my RealVideo clip? | page 77 


What dimensions should I use when capturing my source video? page 85 
Which RealVideo codec should I choose when encoding my video? page 79 
How do I ensure that my video’s visual appearance is good? page 82 


(Table Page 1 of 2) 
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RealVideo Clips (continued) 


Question Answer 
How do I keep a RealVideo clip from appearing distorted? page 76 


Which uncompressed video file formats can I turn into RealVideo clips? | page 86 


What streaming speeds does a RealVideo clip use? page 87 


When should I use variable bit rate encoding? page 89 
(Table Page 2 of 2) 


Flash Clips 


If you produce Macromedia Flash animations, Chapter 5 explains how to 
optimize your Flash Player clip for streaming. 


Flash Clips 
Question Answer 
What versions of Flash can RealOne Player play? page 92 
How much bandwidth does a Flash clip use when it streams? page 92 
What Flash production techniques ensure high-quality streaming? page 94 
How do I combine Flash with a RealAudio soundtrack? page 96 
Can I use Flash timeline commands such as Play, Stop, and Go To? page 99 
Can I use Flash commands to control RealOne Player? page 100 
Can I use Load Movie to import a second clip into my main clip? page 102 
Does a streaming Flash presentation support secure transactions? page 104 
How do I prepare my Flash Player clip for streaming? page 105 


RealText Markup 


Chapter 6 explains the RealText markup for creating timed text. Appendix E 
provides a quick reference for RealText tags and attributes. 


RealText Markup 
Question Answer 
What languages does RealText support? page 112 
How much bandwidth does RealText need? page 113 
How do I make text scroll up, or move from right to left? page 115 


(Table Page 1 of 2) 
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RealText Markup (continued) 


Question Answer 

Can I create a transparent RealText background? page 116 
How do I specify how long a RealText clip lasts? page 118 
How do I control when and where text appears in the RealText window? | page 123 
Can I erase all the text in the RealText window at some point? page 125 
What fonts and font sizes can I use? page 127 
Can I use HTML-type tags, such as <b> and <p>? page 135 
How do I center text in the window? page 136 
Can I link RealText to an HTML page or media clip? page 138 


How do I use RealText hyperlinks to control playback in RealOne Player? | page 140 
(Table Page 2 of 2) 


RealPix Markup 


See Chapter 7 for instructions on creating a RealPix slideshow from still 
images. Appendix F summarizes RealPix tags and attributes. 


RealPix Markup 


Question Answer 

Should I use RealPix or SMIL 2.0 to create slideshows? page 148 
What types of images can I use in a RealPix slideshow? page 150 
Can I control how GIFs animate within a slideshow? page 175 
Does RealPix support image transparency? page 151 
How large can the file sizes for my slideshow images be? page 154 
Where do I specify the RealPix display window dimensions? page 159 
How do I control how much bandwidth RealPix uses? page 161 
Can my slideshow use images on different servers? page 166 
Can I deliver a RealPix slideshow with a Web server? page 166 
How do I create effects such as fades and wipes? page 170 
How do I zoom in on an image, or pan around a large image? page 176 
Can I show only part of an image, or display two images at once? page 179 
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Basic SMIL Questions 
Chapter 8 explains the basics of using SMIL 2.0 in a RealOne Player 
presentation. 

Basic SMIL 2.0 Issues 

Question Answer 
Why should I use SMIL? page 192 
What versions of RealPlayer can play SMIL 2.0 presentations? page 193 
Besides more features, are there differences between SMIL 1.0 and 2.0? _| page 206 
How do I update my SMIL 1.0 presentation to SMIL 2.0? page 207 
Where can I get the SMIL 2.0 specification? page 191 
Will my presentation work with other SMIL-based players? page 196 
How do I write a SMIL file? page 197 
Is a closing slash always necessary with a SMIL tag? page 201 
How do I add comments to a SMIL file? page 202 
What values can I use for the ID in a SMIL tag? page 202 
What is the rn: prefix I see in some SMIL attributes? page 203 
How can I view the SMIL file for a streaming presentation? page 206 


Clips and URLs 


Chapter 9 is your primary resource for learning about clip source tags and 
URLs. Chapter 21 contains information about servers and streaming 


protocols. 

Clips and URLs 
Question Answer 
How do I introduce a clip, such as a video, into a presentation? page 209 
Should a clip source tag have an ID? page 210 
How do I set an image clip’s streaming speed? page 210 


Can I treat a SMIL or Ram file like a clip and use it in another SMIL file? | page 214 


What URLs should I use in my SMIL file as I develop it? page 216 
How do I move my clips from my desktop computer to a server? page 506 
When I stream my clips, do they all need to have individual URLs? page 217 


(Table Page 1 of 2) 
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Clips and URLs (continued) 


Question Answer 

What is Real Time Streaming Protocol (RTSP)? page 505 
How do I write an RTSP URL? page 218 
How do I write an HTTP URL? page 219 
Does RealOne Player cache files like a Web browser? page 219 
What is the CHTTP protocol? page 219 


(Table Page 2 of 2) 


Colors and Transparency 


SMIL and RealNetworks’ SMIL customizations give you many ways to add 
color to your presentation, as well as to modify the colors in existing clips to 
create transparency or partial transparency. 


Colors and Transparency 


Question Answer 

What color values does SMIL accept? page 553 
How do I add a background color to a region that plays a clip? page 290 
How do I make the background color appear only when the clip plays? _| page 290 
Can I make the region background color partially transparent? page 290 
Can I change a region background color when a clip starts? page 291 
Can I change the region background color while a clip plays? page 423 
How do I turn an entire clip partially transparent? page 223 


How can I make a clip’s opaque background transparent, or vice versa? _| page 223 


Can I turn a range of colors in a clip transparent? page 224 
Can I substitute a certain color for a clip’s transparent background? page 227 
Can I make a clip become more (or less) transparent as it plays? page 434 


Can I create a solid block of color other than a region background color? | page 213 
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Layouts 
Chapter 12 explains how to lay out clips in the RealOne Player media playback 
pane. 

Layouts 

Question Answer 
Where in the SMIL file do I define the layout? page 275 
Is a SMIL region like an HTML frame? page 268 
How do I set my presentation’s overall size? page 276 
Can I make a clip play in a separate window? page 277 
How do a define the size of the region in which a clip plays? page 281 
How do I specify which clips play in which regions? page 287 
Can I play one clip in front of another? page 288 
How do I put a logo in front of my video? page 292 
How do I center a clip in a region? page 295 
How can I make my clip scale up or down to fit the region? page 301 
Can I make the same clip display in more than one region? page 307 


Basic Timing and Groups 


Refer to Chapter 13 for basic information about timing presentations. 
Chapter 11 explains how to organize clips into groups. 


Basic Timing and Groups 


Question Answer 
“How doI make clips play one after another? ss—=<“<«*‘;*s*iz ge AT ~C*W 

How do I play several clips at the same time? page 249 
Can I make an entire group of clips stop when one of the clips finishes? | page 320 
How do I let the viewer select which clip to play? page 259 
How do I create a clip preview? page 316 
Can I make a clip repeat? page 323 
How do I specify how long an image clip displays? page 317 
Can I make a clip play indefinitely? page 318 
Can I use timing values with groups as well as clips? page 315 


(Table Page 1 of 2) 
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Basic Timing and Groups (continued) 


Question Answer 
How do I make a clip freeze on screen after it stops playing? page 327 
How do I make a clip display throughout the presentation? page 330 


How do I delay when a clip starts playing? page 314 


(Table Page 2 of 2) 


Advanced Timing 


Chapter 14 explains the advanced timing features, which build on the basic 
timing features described in Chapter 13. 


Advanced Timing 


Question Answer 

Can I start or stop an element when any one of multiple events occur? page 342 
How do I start or stop a clip when a clip in another group starts or stops? | page 342 
Can I start or stop a clip when another clip repeats? page 344 
How do I start or stop a clip when the viewer clicks an icon? page 346 
How can I coordinate all clips with a broadcast? page 352 
Can I prevent a clip from restarting? page 352 
Can I create an effect similar to a Javascript rollover? page 346 
How do I launch a clip on a keystroke? page 349 


Hyperlinks 
Chapter 15 explains how to create hyperlinks in a SMIL presentation. 
Hyperlinks 

Question Answer 
How do I create an image map over a clip? page 361 
Can a SMIL link have an alt value? page 370 
How do I open a link with a keystroke? page 368 
How do I link my SMIL presentation to a Web page? page 371 
Can I open a link in a browser frame? page 375 
How do I open an HTML page in the related info pane? page 373 
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Hyperlinks (continued) 


Question Answer 

Does RealOne Player pause when a Web page opens? page 376 
How do I open a link automatically? page 369 
How do I link my SMIL file to another streaming presentation? page 377 
Can I open a linked clip or SMIL presentation in a new window? page 378 
Can RealText include hyperlinks, too? page 138 


(Table Page 2 of 2) 


Special Effects 


Chapter 16 and Chapter 17 explain transition effects and SMIL animations, 
respectively, the two features that allow you to create special effects with clips. 


Special Effects 

Question Answer 

How do I introduce a new clip with a transition effect? page 393 
Can I control how long a transition effect takes to complete? page 407 
How do I keep a clip visible long enough for a transition effect to occur? | page 412 
Can I stop a transition effect before it completes? page 408 
How do I fade a clip to or from a solid color? page 414 
How do I fade a video into the next video? page 415 
Can I fade the volume of an audio clip up or down? page 423 
How do I select what clip and property I want to animate? page 422 
How do I make a clip grow or shrink? page 425 
How do I move a clip around the screen? page 435 
How do I animate colors? page 434 
How do I make an animation flow smoothly? page 429 
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Advanced Streaming 


Chapter 18 and Chapter 19 cover switching and prefetching, respectively, two 
advanced features that allow you to stream different clips to different viewers, 
and maintain greater control over bandwidth use. 


Advanced Streaming 


Question Answer 


How do I deliver different clips to different viewers? page 439 


Do I always have to use a <switch> tag when I present multiple choices? | page 441 


What attributes can RealOne Player evaluate when choosing a clip? page 442 
Can RealOne Player evaluate more than one attribute at a time? page 456 
How do I deliver clips in different languages to different viewers? page 443 
How do I stream clips at different bandwidths to different viewers? page 446 
Can I add captions and audio descriptions to aid viewer accessibility? page 448 


How do I deliver different clips to Windows, Macintosh, and Linux users? | page 450 


Can I use a <switch> tag to stream different sizes of videos? page 457 
How do I stream clip data to RealOne Player before the clip plays? page 468 
How much bandwidth can I use for prefetching clip data? page 469 
How much clip data can I stream in advance of clip playback? page 471 
Web Page Embedding 
See Chapter 20 for information on embedding your streaming presentation 
directly in a Web page. 
Web Page Embedding 

Question Answer 
Will an <EMBED> tag work with Microsoft Internet Explorer? page 481 
How do I use both <OBJECT> and <EMBED> tags? page 488 
What is RealOne Player’s ActiveX Class ID? page 487 
What is a .rpm file? page 483 
How do I set my presentation’s size in my Web page? page 486 
How do I add RealOne Player controls to my Web page? page 489 
How do I make all the controls work together? page 495 


(Table Page 1 of 2) 


550 


APPENDIX B: Production Tasks 


Web Page Embedding (continued) 


Question Answer 

Can I center my clip in an HTML table? page 498 
Can I make my presentation start as soon as the Web page loads? page 500 
How do I set shuffle play? page 501 
How do I lay out my SMIL presentation in my Web page? page S01 
Can I use Javascript or VBScript to control my embedded presentation? | page 482 
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Presentation Delivery 


Refer to Chapter 21 for instructions on delivering your presentation from 
Helix Universal Server or a Web server. That chapter also explains how to link 
your presentation to your Web page. 


Presentation Delivery 


Question Answer 

What is a Ram file? page 503 
How do I write a Ram file? page 507 
What URLs do I use in a Ram file? page 505 
Why does Helix Universal Server use RTSP? page 505 
How do I link my Web page to my clips through the Ram file? page 509 
Can I use the Ram file to open HTML pages in RealOne Player? page 511 
How do I open my streaming clip at double-size or full-screen? page 514 
How do I use Ramgen so that I don’t need a Ram file? page 519 
What MIME types do I need to set on a Web server? page 523 
Can a Web server perform all the functions of Helix Universal Server? page 524 
How can J advertise my presentation? page 527 
Where do I get a download logo for RealOne Player? page 528 
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COLOR VALUES 


Most markup, such as RealText and RealPix, can use color names 
and hexadecimal values for color attributes. SMIL 2.0 supports the 
color values defined in the Cascading Style Sheets 2 (CSS2) 
specification, letting you use RGB values as well. 


For More Information: The CSS2 color specification is located at 
http://www.w3.org/TR/REC-CSS2/syndata.html#value- 
def-color. 


Using Color Names 
The simplest, but most limited, way to specify a color is to use a predefined 
color name, as shown in the following example: 


backgroundColor="blue” 


RealText, RealPix, SMIL 2.0, CSS2, and HTML 4.0 all support the same 16 
predefined color names, which are listed in the following table. Each color 
name’s hexadecimal and RGB color value is included as reference, but you 
specify only the name when defining the color. 


white silver gray black 
#FFFFFF #COCOCO #808080 #000000 
rgb(255,255,255) |rgb(192,192,192) |rgb(128,128,128) /rgb(0,0,0) 
yellow fuchsia red maroon 
#FFFFOO #FFOOFF #FFOO00 #800000 
rgb(255,255,0) rgb(255,0,255) rgb(255,0,0) rgb(128,0,0) 
lime olive green purple 
#OOFFOO #808000 #008000 #800080 
rgb(0,255,0) rgb(128,128,0) rgb(0,128,0) rgb(128,0,128) 
aqua teal blue navy 
H#OOFFFF #008080 #OOOOFF #000080 
rgb(0,255,255) rgb(0,128,128) rgb(0,0,255) rgb(0,0,128) 
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Defining Hexadecimal Color Values 


For most color attributes, including those in RealText, RealPix, SMIL, and 
embedded playback, you can specify any RGB color by using a hexadecimal 
(base 16) value and a leading pound sign (#), as shown in the following 
example: 


backgroundColor="#34F9A8” 
Hexadecimal numbering uses the digits 0 through 9, along with the “digits” A 
through F. Decimal 5 and hexadecimal 5 are the same value, for example, but 


decimal 10 corresponds to hexadecimal A, decimal 15 corresponds to 
hexadecimal F, and decimal 16 corresponds to hexadecimal 10. 


Using Six-Digit Hexadecimal Values 


Hexadecimal color values are typically six digits, in which the first pair of 
digits defines an RGB red value, the second pair specifies a green value, and 
the last pair specifies a blue value. Each hexadecimal pair can specify 256 
colors (16 x 16), thereby replicating the RGB single-color values of 0 to 255. 
Each hexadecimal red, green, or blue color value ranges from 00 (no color) to 
FF (full color). Here are some examples: 


+ #000000 is black 

+ #FF0000 is bright red 

+ #FFFFOO is bright yellow 
+ #OO00FF is bright blue 

+ #FFFFFF is white 


Note: Letter case does not matter for hexadecimal digits. 
Hence, #ACBD5F is equivalent to #acbd5f. 


Defining Three-Digit Hexadecimal Values 


For SMIL 2.0 color values, you can use a three-digit value, in which each digit 
specifies a red, green, and blue RGB value, respectively, in place of any six-digit 
hexadecimal value: 


backgroundColor="#3F8” 


The three-digit value is converted to a six-digit value by duplicating each digit. 
The preceding three-digit value is therefore equivalent to the following value: 
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backgroundColor="#33FF88” 


Tip: Using the three-digit notation, you can quickly specify 
white (#FFF) or black (#000). 


Specifying RGB Color Values 


Any SMIL 2.0 color attribute accepts a red/green/blue (RGB) value, as shown 
in the following example: 


backgroundColor="rgb(128,56,10)” 


Tip: Spaces between the color values are OK, so 
rgb(128, 56, 10) works, too. 


Using Standard RGB Color Values 


In the RGB color scheme, there are 256 possible values for each of the red, 
green, and blue components of a color pixel on a computer screen. In RGB 
notation, each color value ranges from 0 (no color) to 255 (full color). A full 
color value combines a red, a green, and a blue value. Here are a few examples 
of RGB color values: 


+ rgb(0,0,0) is black 

+ rgb(255,0,0) is bright red 

+ rgb(255,255,0) is bright yellow 
+ rgb(0,0,255) is bright blue 

+ rgb(255,255,255) is white 


Specifying RGB Percentages 


SMIL also supports percentage values for RGB coordinates, in which 0% 
corresponds to the value 0, and 100% corresponds to the value 255. Here is an 
example that is equivalent to rgb(25,191,103): 


backgroundColor=“rgb(10%,75%,40.5%)” 


Tip: Decimal values are acceptable for percentages. In all cases, 
RealOne Player converts the percentage values to their closest 
RGB equivalents. 
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Tips for Defining Color Values 


- Both the RGB and hexadecimal color schemes let you define the same 
colors. In SMIL 2.0, use whichever method you prefer. 


+ Illustration programs typically define colors uisng the RGB scheme, while 
the hexadecimal scheme is common to HTML markup programs. Many 
newer programs support both schemes, though, and let you convert easily 
between them. Web resources are also available to convert an RGB value to 
hexadecimal, and vice versa. 


+ You can mix color names, RGB values, and hexadecimal values within a 
SMIL file, using RGB for some attributes and hexadecimal values for 
others, for example. 


+ Most color monitors can display all the colors that you can define 
through SMIL. Ifa monitor cannot display the full range of colors, it 
displays the nearest approximations. 


+ Keep in mind that some viewers may be color blind (especially between 
greens and reds), or may not be able to discriminate between subtle color 
differences. It’s a good idea always to use highly contrasting colors, such 


as bright, light text on a dark background. 
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PART 


SYNTAX SUMMARIES 


For the advanced user, these appendixes summarize the tags 
and attributes for various markup used with RealOne Player. 
Appendix D summarizes SMIL 2.0 tags. Appendix E and 
Appendix F cover RealText and RealPix, respectively. Appendix G 
lists Ram file parameters, while Appendix H explains common 
file extensions. Appendix | lists the RealOne Player language 


codes that you can use in SMIL. 


APPENDIX 


D 


SMIL TAG SUMMARY 


Intended for advanced users, this appendix provides a reference to SMIL 2.0 tags 
and attributes. Be sure to familiarize yourself with “Conventions Used in this 
Guide” on page 13, which explains the typographical conventions used in this 


appendix. 


<smil>...</smil> 


The <smil> and </smil> tags must start and end the SMIL markup. The SMIL 2.0 namespace 
declaration is required. You must declare the RealNetworks extension namespace if your SMIL 
file includes a customized attribute that uses the rn: prefix. 


SMIL 2.0 <smil> Tag Namespaces 


Namespace Features Defined Reference 


xmlns=“http://www.w3.org/2001/SMIL20/Language” SMIL 2 Language Profile 


xmlns:rn=“http://features.real.com/2001/SMIL20/Extensions” | RealNetworks extensions 


page 204 


xmlns:cv=“http://features.real.com/systemComponent” version checking page 454 


Example 

<smil xmlns=“http://www.w3.org/2001/SMIL20/Language” 

xmlns:rn=“http://features.real.com/2001/SMIL20/Extensions”> 
...all additional SMIL 2.0 markup... 

</smil> 


Header Tags 


The SMIL file header, created between <head> and </head> tags, contains tags that let you 
define the presentation’s layout, information, transitions, and other features. For basic 
information about defining the SMIL file header, see “Header and Body Sections” on page 198. 
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<meta/> 


The header region’s <meta/> tags provide presentation information. A <meta/> tag can also set 
a base URL for source clips in the SMIL file. The content and name attributes are required for 
each <meta/> tag. For basic information about the <meta/> tag, see “Defining Information for 
the SMIL Presentation” on page 240. 


SMIL 2.0 <meta/> Tag Attributes 


Attribute Value Function Reference 
content | text|URL Provides the content for the name attribute. page 240 
name abstract Gives the presentation abstract. page 240 
author Lists the presentation author’s name. page 240 
base Sets the base URL for the source clips. page 217 
copyright Supplies the presentation copyright. page 240 
title Gives the presentation title. page 240 
Examples 


<meta name="author” content="Jane Morales” /> 

<meta name="title” content="Multimedia My Way”/> 

<meta name="copyright” content="(c)2001 Jane Morales” /> 
<meta name="base” content="rtsp://helixserver.example.com/"/> 


<layout>...</layout> 


The <layout> and </layout> tags within the SMIL header contain other tags that define the 
layout of visual clips. Within the layout section, you define a root-layout area and separate 
regions for clips. You can also define secondary media windows. 


<root-layout/> 


Within the layout section, a single <root-layout/> tag sets the overall size of the main media 
playback pane. Clips play in regions created within the root-layout area. They do not play in 
the root-layout area directly. The height and width attributes are required for the <root-layout/> 
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tag. For basic information about the <root-layout/> tag, see “Defining the Main Media 


Playback Pane” on page 276. 


SMIL 2.0 <root-layout/> Tag Attributes 


Attribute Value Default Function Reference 
backgroundColor color_value black | Sets the window background color. page 290 
rn:contextWindow auto|openAtStart |auto | Sets when related info pane opens. page 374 
height pixels 0 Sets the main window height. page 276 
rn:resizeBehavior percentOnly|zoom |zoom | Controls whether regions resize. page 279 
width pixels 0 Sets the main window width. page 276 


Example 
<layout> 


<root-layout backgroundColor="maroon” width="320” height="240"/> 
<region ...playback region defined.../> 
<region ...playback region defined.../> 


</layout> 


<topLayout>...</topLayout> 


Following <root-layout/>, <topLayout>...</topLayout> tags can define the overall size of a 


secondary media window that is detached from the main media playback pane. You assign 


clips to play in regions within this window. You cannot assign clips directly to a <topLayout> 


window. The height and width attributes are required for the <topLayout> tag. For basic 


information about the <topLayout> tag, see “Creating Secondary Media Playback Windows” on 


page 277. 
SMIL 2.0 <topLayout/> Tag Attributes 
Attribute Value Default Function Reference 
backgroundColor color_value black Sets the background color. page 290 
close onRequest| onRequest | Determines when the window page 277 
whenNotActive closes. 
height pixels (none) Sets the window height. page 277 
open onStart|whenActive | onStart Controls when the window page 277 
opens. 
rn:resizeBehavior percentOnly|zoom | zoom Controls whether regions resize. | page 279 
width pixels (none) Sets the window width. page 277 
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Example 
<layout> 
<root-layout.../> 


...main media playback pane regions defined... 
<topLayout width="180”" height="120”" open="whenActive” close="whenNotActive”> 
...secondary media playback window regions defined... 


</topLayout> 
</layout> 


<region/> 


Following <root-layout/>, or between <topLayout> and </topLayout>, <region/> tags define the 


size, placement (relative to the pane or window), and properties of each region used to play 
clips. A unique id attribute is required for each <region/> tag. For basic information about the 


<region/> tag, see “Defining Playback Regions” on page 279. 


SMIL 2.0 <region/> Tag Attributes 


Attribute Value Default Function Reference 

backgroundColor | inherit|transparent| | transparent | Sets the region background color. page 290 
color_value 

bottom auto|pixels | auto Sets the region’s offset from the page 281 
percentage bottom of the window. 

fit fill | hidden | meet | hidden Controls how clips fit the region. page 301 
scroll|slice 

height auto|pixels | auto Sets the region’s height. page 281 
percentage 

id name (none) Creates an ID for assigning clips. page 280 

left auto|pixels | auto Sets the region’s offset from the page 281 
percentage window’s left side. 

rn:opacity percentage 100% Reduces background opacity. page 290 

regionName name (none) Provides a name for certain features. | page 280 

right auto|pixels | auto Sets the region’s offset from the page 281 
percentage window’s right side. 

showBackground | always|whenActive | always Determines when the background page 290 

color appears. 

soundLevel percentage 100% Cuts or boosts a clip’s audio volume. | page 292 

top auto|pixels | auto Sets the region’s offset from the top | page 281 
percentage of the window. 
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SMIL 2.0 <region/> Tag Attributes (continued) 


Attribute Value Default Function Reference 
width auto|pixels | auto Defines the region’s width. page 281 
percentage 
z-index number 0 Sets the stacking order when the page 288 
region overlaps another region. 
(Table Page 2 of 2) 
Example 


The following example defines both a region and a subregion: 


<layout> 


<root-layout .../> 
<region id="video_region” top="5" left="5”" width="240" height="180”" z-index="3” 
backgroundColor="blue” showBackground=“whenActive”> 
<region id="logo_region” bottom="10%" right="15%”" fit=" Fill” /> 
</region> 


</layout> 


<regPoint/> 


Between the <layout> and </layout> tags, <regPoint/> tags define registration points that 


determine where and how clips are placed in regions. The id attribute is required for the 


<regPoint/> tag. For basic information about the <regPoint/> tag, see “Positioning Clips in 
Regions” on page 29S. 


SMIL 2.0 <regPoint/> Tag Attributes 


Attribute Value Default Function Reference 

bottom | auto|pixels | auto Sets the point’s offset from the region’s page 298 
percentage bottom border. 

id name (none) | Creates an ID for assigning the point to clips. | page 295 

left auto|pixels | auto Sets the point’s offset from the region’s left | page 298 
percentage side. 

right auto|pixels | auto Sets the point’s offset from the region’s right | page 298 
percentage side. 

top auto|pixels | auto Sets the point’s offset from the region’s top _| page 298 
percentage border. 

regAlign | topLeft|topMid| topLeft | Specifies how clips align to the point. page 296 
topRight|midLeft| 
center|midRight| 
bottomLeft|bottomMid| 
bottomRight 
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Example 
<layout> 


...windows and regions defined... 


<regPoint id="middle” left="50%” top="50%”" regAlign="center”/> 


</layout> 


<transition/> 


Following the layout section, <transition/> tags define transition effects that occur when clips 
start or stop. The id and type attributes are required for the <transition/> tag. For basic 
information about the <transition/> tag, see “Defining Transition Types” on page 393. 


SMIL 2.0 <transition/> Tag Attributes 


Attribute Value Default Function Reference 
borderColor | blend|color_value | black Specifies a border color or a blended border. | page 410 
borderWidth | pixels 0 Specifies a border width. page 410 
fadeColor color_value black Sets a color for fades. page 410 
direction forward|reverse forward Specifies the transition direction. page 407 
dur time_value 1s Defines the length of the transition effect. | page 407 
endProgress |0.0-1.0 1.0 Ends the effect before it completes fully. page 408 
horzRepeat | integer 1 Sets a number of horizontal repetitions. page 409 
id name (none) Creates an ID for assigning the effect. page 393 
startProgress | 0.0-1.0 0.0 Starts the effect at a midway point. page 408 
subtype subtype_name (varies) Defines an optional subtype for each type. | page 393 
type type_name (none) Specifies the main transition type. page 393 
vertRepeat | integer 1 Sets a number of vertical repetitions. page 409 
Example 

<layout> 


...windows, regions, and registration points defined... 


</layout> 


<transition id="sixteenBoxes" type="fourBoxWipe" subtype="cornersOut" horzRepeat="2" 
vertRepeat="2" dur="2s"/> 
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Clip Source Tags 
You add clips to a presentation with one of the following source tags: 


<animation/> animation clip such as Macromedia Flash 


<audio/> audio clip such as RealAudio 

<brush/> color block used in place of a media clip 
<img/> image file in GIF, JPEG, or PNG format 
<ref/> any type of clip not covered by the other tags 
<text/> static text file 


<textstream/> streaming text clip such as RealText 


<video/> video clip such as RealVideo 


Except for <brush/>, the choice of tag does not affect playback. All clip source tags can use 
<ref/>, for example. The src attribute is required for all clip source tags except <brush/>. For 
basic information about the clip souce tags, see “Creating Clip Source Tags” on page 209. 


SMIL 2.0 Clip Tag Attributes 


Attribute Value Default Function Reference 

abstract text (none) Provides a clip abstract. page 238 

alt text (none) Provides alternate text. page 242 

author text (none) Lists the clip’s author. page 238 

rn:background _| percentage 100% Adjusts background opacity. page 223 

Opacity 

begin time_value Os Delays normal playback time. page 314 

bgcolor color_value (none) Substitutes color for transparency. | page 227 
Use in a <param/> tag. 

bitrate bits_per_second 12288 Sets a static clip’s streaming speed. | page 210 
Use in a <param/> tag. 

rn:chromaKey color_value (none) Turns selected color transparent. | page 224 

rn:chromaKey percentage 0% Adds opacity to rn:chromaKey. page 225 

Opacity 

rn:chromaKey #nnnnnn (none) Widens range of rn:chromaKey. page 225 

Tolerance 

color color_value black Sets color in a <brush/> tag. page 213 

clipBegin time_value Os Specifies the clip’s internal timing | page 316 


mark where playback begins. 


(Table Page 1 of 3) 
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SMIL 2.0 Clip Tag Attributes (continued) 


Attribute Value Default Function Reference 
clipEnd time_value (none) Specifies the clip’s internal timing | page 316 
mark where playback ends. 
copyright text (none) Lists the copyright for the clip. page 238 
rn:delivery client|server client Specifies server-side or client-side | page 210 
action. Use in a <param/> tag. 
dur time_value|media| media Sets the total time the clip or one | page 317 
indefinite of its repeating cycles plays. 
end time_value (none) Sets the end time for the clip. page 314 
erase never|whenDone whenDone | Specifies if the clip remains when __| page 330 
its fill period expires. 
fill auto|default|freeze| auto| Determines the fill state when the | page 327 
hold|remove|transition | default clip is no longer active. 
fillDefault auto|freeze|hold| inherit Sets a default fill for contained page 334 
inherit|remove| elements, such as animations. 
transition 
id name (none) Names clip for reference by other | page 210 
elements, such as animations. 
longdesc text (none) Provides a long description. page 242 
rn:mediaOpacity | percentage 100% Adjusts overall transparency. page 223 
mediaRepeat strip|preserve preserve | Strips out native repetitions. page 325 
readIndex integer 0 Determines how assistive devices | page 243 
read clip information. 
regAlign topLeft|topMid| topLeft Specifies which part of the clip page 296 
topRight|midLeft| aligns to the registration point. 
center|midRight| 
bottomLeft|bottomMid| 
bottomRight 
region region_ID (none) Assigns the clip to a region. page 287 
regPoint regPont_ID| (none) Assigns the clip to a predefined page 287 
topLeft|topMid| registration point, or specifies a 
topRight|midLeft| point on the region. 
center|midRight| 
bottomLeft|bottomMid| 
bottomRight 
reliable false|true false Ensures reliable transmission. page 212 
repeatCount integer |indefinite | 0 Repeats the clip the specified page 323 
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fractional_value 


number of times, or indefinitely. 
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SMIL 2.0 Clip Tag Attributes (continued) 


Attribute Value Default Function Reference 
repeatDur time_value|indefinite | Os Repeats the clip the specified page 323 
amount of time. 
restart always|default|never| | always Determines if the clip can replay. | page 352 
whenNotActive 
src URL (none) Provides a full or relative URL for | page 209 
the clip. Not used with <brush/>. 
syncBehavior canSlip|default| default Sets how the clip synchronizes to | page 252 
independent|locked its group. 
title text (none) Provides a title for the clip. page 238 
transIn <transition/> ID (none) Assigns a starting transition effect. | page 411 
transOut <transition/> ID (none) Assigns an ending transition effect. | page 411 


(Table Page 3 of 3) 


Examples 

<video id="video1” src="rtsp://helixserver.example.com/media/video2.rm” region="video_region” 
begin="40s” clipBegin="5100ms” clipEnd="4.5min” fill="freeze”/> 

<audio id="audio1” src="rtsp://helixserver.example.com/media/music.rm” 
dur="10.5s" repeatCount="5" /> 

<img id="image1” src="http://www.example.com/poster.jpg” region="image_region” dur="15s"> 
<param name="bitrate” value="5000" rn:delivery="server” /> 

</img> 


<brush color="blue” region="region_1” dur="5s"/> 


<prefetch/> 


Chapter 19 describes the <prefetch/> tag, which lets you download clip data before the clip 
plays. The <prefetch/> tag can use many SMIL timing attributes to set limits on prefetching. It 
also has its own attributes that control the data download. The id attribute is required. 


SMIL 2.0 <prefetch> Tag Attributes 


Attribute Value Default Function Reference 
bandwidth bits_per_second | 100% Sets the bandwidth used to get data. | page 469 
percentage 
begin time_value Os Delays the prefetch start. page 314 
clipBegin time_value Os Specifies the clip’s internal timing page 316 
mark where prefetching begins. 


(Table Page 1 of 2) 
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SMIL 2.0 <prefetch> Tag Attributes (continued) 


Attribute Value Default Function Reference 
clipEnd time_value (none) Specifies the clip’s internal timing page 316 
mark where prefetching ends. 
dur time_value|media| media Sets the duration for prefetching. page 317 
indefinite 
end time_value (none) Sets the end time for prefetching. page 314 
id name (none) Names prefetching element for page 202 
reference by other SMIL elements. 
mediaSize bytes | percentage 100% Sets how much data to fetch based _| page 471 
on clip size. Overrides mediaTime. 
mediaTime time_value| 100% Specifies the amount of data to fetch | page 472 
percentage based on the clip’s duration. 
restart always|default|never| | always Determines if prefetching can restart. | page 352 
whenNotActive 
STC URL (none) Gives the URL to the prefetched clip. | page 209 
syncBehavior canSlip|default| default Sets how <prefetch/> synchronizes | page 252 
independent|locked to its group. 
(Table Page 2 of 2) 
Group Tags 


Chapter 11 explains the group tags that you can use to create the superstructure for your 


presentation’s timeline. 


<seq>...</seq> 


The <seq> and </seq> tags play the enclosed clips in sequence. No attributes are required for a 


<seq> tag, which is described in “Playing Clips in Sequence” on page 247. 


SMIL 2.0 <seq> Tag Attributes 


Attribute Value Default Function Reference 

begin time_value Os Delays the normal group playback. _| page 315 

dur time_value|media| media Sets the total time the group plays. | page 317 
indefinite 

end time_value (none) Sets an end time for the group. page 315 

fill freeze|hold|remove remove | Determines the fill state when the page 332 
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SMIL 2.0 <seq> Tag Attributes (continued) 


Attribute Value Default Function Reference 

fillDefault auto|freeze|hold| inherit | Sets a default fill for contained clips. | page 334 
inherit|remove| 
transition 

id name (none) Names the group for reference by page 202 

other elements. 

repeatCount integer |indefinite | 0 Repeats the group the specified page 323 
fractional_value number of times, or indefinitely. 

repeatDur time_value | Os Repeats the group the specified page 323 
indefinite amount of time. 

restart always|default|never| | always Determines if the group can restart. | page 352 
whenNotActive 

restartDefault always|inherit|never| | inherit Specifies a restart value the group page 353 
whenNotActive Passes to its elements. 

syncBehavior canSlip|default| default | Determines how the group page 252 
independent|locked synchronizes to its containing group. 

syncBehavior canSlip|independent| | inherit Sets the default syncBehavior value | page 255 

Default inherit|locked for the elements the group contains. 

synclolerance | time_value| inherit | Creates a tolerance value for locked | page 257 
inherit elements in the group. 

syncTolerance time_value (none) Sets a tolerance value inherited by page 257 

Default other groups the group contains. 

(Table Page 2 of 2) 
Example 


<seq repeatDur="30min"> 
<audio src="rtsp://helixserver.example.com/one.rm”/> 
<audio src="rtsp://helixserver.example.com/two.rm”/> 


</seq> 


<par>...</par> 


The <par> and </par> tags make enclosed clips play at the same time. No attributes are required 
for a <par> tag, which is described in “Playing Clips in Parallel” on page 249. 


SMIL 2.0 <par> Tag Attributes 


Attribute Value Default = Function Reference 
abstract text (none) | Provides an abstract for the group. page 238 
author text (none) Lists an author for the group. page 238 


(Table Page 1 of 2) 
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SMIL 2.0 <par> Tag Attributes (continued) 


Attribute Value Default Function Reference 
begin time_value Os Delays the normal playback time. page 315 
copyright text (none) Lists the copyright for the group. page 238 
dur time_value|media| media Sets the total time the group plays. page 317 
indefinite 
end time_value (none) Sets an end time for the group. page 315 
endsync all|first|ID|last| last Determines when the group ends. page 320 
media 
fill freeze|hold|remove |remove | Determines the fill state when the page 332 
group is no longer active. 
fillDefault auto|freeze|hold| inherit | Sets a default fill for contained clips. | page 334 
inherit|remove| 
transition 
id name (none) Names the group for reference by page 202 
other elements. 
repeatCount integer |indefinite | 0) Repeats the group the specified page 323 
fractional_value number of times, or indefinitely. 
repeatDur time_value | Os Repeats the group the specified page 323 
indefinite amount of time. 
restart always|default|never| | always | Determines ifthe group can restart. | page 352 
whenNotActive 
restartDefault always|inherit|never| jinherit | Specifies a restart value the group page 353 
whenNotActive passes to its elements. 
syncBehavior canSlip|default| default | Determines how the group page 252 
independent|locked synchronizes to its containing group. 
syncBehavior canSlip|independent| jinherit | Sets the default syncBehavior value for | page 255 
Default inherit|locked the elements the group contains. 
syncTolerance time_value | inherit | Creates a tolerance value for locked page 257 
inherit elements in the group. 
syncTolerance time_value (none) Sets a tolerance value inherited by page 257 
Default other groups the group contains. 
title text (none) Lists a title for the group. page 238 
(Table Page 2 of 2) 
Examples 
<par> 


<video src="newsong.rm”/> 
<textstream src="newsong.rt”/> 


</par> 
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<par endsync="text” repeatCount="2”" begin="4s"> 


<video src="newsong.rm”/> 
<textstream id="text” src="newsong.rt”/> 


</par> 


<excl>...</excl> 


APPENDIX D: SMIL Tag Summary 


The <excl> and </excl> tags create an exclusive group in which only one clip can play at a time. 


A duration is required for the <excl> tag if all elements in the group use interactive timing. For 


basic information on this tag, see “Creating an Exclusive Group” on page 259. 


SMIL 2.0 <excl> Tag Attributes 


Attribute Value Default Function Reference 

begin time_value Os Delays the normal playback time. page 315 

dur time_value|media| media Sets the total time the group plays. page 317 
indefinite 

end time_value (none) | Sets an end time for the group. page 315 

endsync all|first|ID|last| last Determines when the group ends. page 320 
media 

Fill freeze|hold|remove |remove | Determines the fill state when the page 332 

group is no longer active. 

fillDefault auto|freeze|hold| inherit | Sets a default fill for contained clips. | page 334 
inherit|remove| 
transition 

id name (none) | Names the group for reference by page 202 

other elements. 

repeatCount integer |indefinite | 0 Repeats the group the specified page 323 
fractional_value number of times, or indefinitely. 

repeatDur time_value | Os Repeats the group the specified page 323 
indefinite amount of time. 

restart always|default|never| | always | Determines if the group can restart. page 352 
whenNotActive 

restartDefault | always|inherit|never| |inherit | Specifies a restart value the group page 353 
whenNotActive passes to its elements. 

syncBehavior canSlip|default| default | Determines how the group page 252 
independent|locked synchronizes to its containing group. 

syncBehavior canSlip|independent| inherit | Sets the default syncBehavior value for | page 255 

Default inherit|locked the elements the group contains. 


(Table Page 1 of 2) 
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SMIL 2.0 <excl> Tag Attributes (continued) 


Attribute Value Default Function Reference 

syncTolerance time_value | inherit | Creates a tolerance value for locked page 257 
inherit elements in the group. 

syncTolerance time_value (none) Sets a tolerance value inherited by page 257 

Default other groups the group contains. 


(Table Page 2 of 2) 


Example 

<excl dur="indefinite”> 
<video src="videol.rm” begin="button1.activateEvent” region="video_region”/> 
<video src="video2.rm” begin="button2.activateEvent” region="video_region”/> 
<video src="video3.rm” begin="button3.activateEvent” region="video_region”/> 

</excl> 


<priorityClass>...</priorityClass> 


These tags create a priority class within an exclusive group. Each priority class, which is 
described in “Modifying Clip Interruption Behavior” on page 261, defines the interruption 
behavior of clips within the exclusive group. No attributes are required for a <priorityClass> tag. 


SMIL 2.0 <priorityClass> Tag Attributes 


Attribute Value Default Function Reference 
higher pause|stop pause | Sets class behavior on interruption by clips with page 263 
higher priority. 
id name (none) | Names the group for reference by other elements. page 202 
lower defer|never defer | Specifies how interrupting clips with lower priority | page 263 
behave. 
pauseDisplay | disable|hide| |show | Sets a clip’s appearance if the clip is paused. page 264 
show 
peers defer|never| |stop | Controls how clips in the same class interrupt each | page 262 
pause|stop other. 
Example 
<excl> 


<priorityClass peers=“pause”> 
<video src="video1.rm” begin="button1.activateEvent” region="video_region”/> 
<video src="video2.rm” begin="button2.activateEvent” region="video_region”/> 
<video src="video3.rm” begin="button3.activateEvent” region="video_region”/> 
</priorityClass> 
</excl> 
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<switch>...</switch> 


The <switch> and </switch> tags, described in “Understanding Switching” on page 439, specify 
elements that RealOne Player chooses between based on certain criteria. No attributes are 
required for the <switch> tag. 

SMIL 2.0 <switch> Tag Attributes 


Attribute Value Function Reference 


id Names the group as a link target for other SMIL files. page 202 


Test Attributes 


Elements within a <switch> group must include a test attribute, such as systemBitrate or 
systemLanguage. You can add a test attribute to any clip source tag, as well as <a/>, <area/>, 
<layout>, <region/>, <prefetch/>, <excl>, <par>, <seq>, <animate/>, <animateColor/>, 
<animateMotion/>, and <set/> tags. 


SMIL 2.0 Test Attributes for Switching 


Attribute Value Function Reference 
systemAudioDesc on|off Tests for an audio descriptions preference. page 448 
systemBitrate bits_per_second | Tests for the bit rate. page 446 
systemCaptions on|off Tests for a captions preference. page 448 
systemComponent component Checks for a component or a version number. | page 453 
systemLanguage language_code | Tests for a language preference. page 443 
systemOperatingSystem |0OS_name Tests for the operating system. page 450 
systemOverdubOrSubtitle | overdub|subtitle | Tests for an overdub or subtitle preference. page 445 
systemRequired prefix Verifies namespace support. page 453 
systemScreenDepth 1|4|8|24|32 Tests for the monitor color depth. page 452 
systemScreenSize pixel_heightX Tests for the monitor size. page 452 
pixel_width 


Examples 

<switch> 
<audio src="seattle_french.rm” systemLanguage="fr” /> 
<audio src="seattle_german.rm” systemLanguage="de"/> 
<audio src="seattle_english.rm”/> 

</switch> 
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<switch> 


<ref src="slides1.rp” systemBitrate="80000"/> 
<ref src="slides2.rp” systemBitrate="20000"/> 


</switch> 


Hyperlink Tags 


<a>...</a> 


The <a>...</a> tags turn the enclosed clip source tag into a hyperlink. For basic information 
about these tags, see “Creating a Simple Link” on page 360. The href attribute is required for 


the <a> tag. 
SMIL 2.0 <a> Tag Attributes 
Attribute Value Default Function Reference 
accesskey key (none) Sets a keystroke that opens the link. _| page 368 
actuate onLoad|onRequest | onRequest | Determines whether or not the link page 369 
requires user activation. 

alt text (none) Supplies alternate text for the link. page 370 
destinationLevel | percentage 100% Specifies the audio level of the target. | page 382 
destination pause|play play Sets the play state of the target when | page 378 
Playstate the link opens. 

external false|true false Sends the link to the browser iftrue. | page 372 
href URL (none) Gives the link URL. page 367 
show new|replace replace Sets the current or a new media page 378 

playback window as the target. 
sourceLevel percentage 100% Sets the audio level of the source. page 382 
sourcePlaystate | pause|play|stop pause|play | Sets the play state of the source. page 378 
tabindex integer 0 Sets the tabbing order for links. page 370 
target name (current | Identifies a window or a SMIL region. | page 375 
window) page 379 

Example 


<a href="http://www.real.com” external="true” sourcePlaystate="pause”> 
<video src="video.rm” region="video_region”/> 


</a> 
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An <area/> tag can define a hot spot hyperlink that can be temporal as well as spatial. It fits 
within a clip source tag pair: 


<video ...> 
<area .../> 
</video> 


The following table lists possible <area/> tag attributes. No attributes are required for this tag, 


but href is typically included. For basic information about the <area/> tag, see “Using the 
<area/> Tag” on page 360. 


SMIL 2.0 <area/> Tag Attributes 


Attribute Value Default Function Reference 
accesskey key (none) Sets a keystroke that opens the link. | page 368 
actuate onLoad|onRequest |onRequest | Determines whether or not the link | page 369 
requires user activation. 
alt text (none) Supplies alternate text for the link. page 370 
begin time_value Os Sets when the link becomes active. page 361 
coords pixels|percentage _| (none) Defines the hot spot size and location. | page 360 
destinationLevel | percentage 100% Specifies the audio level of the target. | page 382 
destination pause|play play Sets the play state of the target when | page 378 
Playstate the link opens. 
dur time_value (none) Sets the total time the link is active. | page 317 
end time_value (none) Sets when the link deactivates. page 361 
external false|true false Sends the link to the browser if true. | page 372 
height pixels media Sets related info pane height in page 374 
height <rm:param>. 
href URL (none) Gives the link URL. page 367 
id name (none) Defines the element ID. page 202 
nohref (none) (none) Indicates that the link has no URL. page 368 
rn:sendTo _osdefaultbrowser| | (none) Specifies a browser window that page 372 
_rpbrowser| opens the HTML page. page 373 
_rpcontextwin 
shape rect|circle| poly rect Sets the hotspot shape. page 362 
show new|replace replace Sets the current or a new media page 378 
playback window as the target. 
sourceLevel percentage 100% Sets the audio level of the source. page 382 
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SMIL 2.0 <area/> Tag Attributes (continued) 


Attribute Value Default Function Reference 
sourcePlaystate | pause|play|stop pause|play | Sets the play state of the source. page 378 
tabindex integer 0 Sets the tabbing order for links. page 370 
target name current Identifies a window or a SMIL region. | page 375 

window page 379 
width pixels 330 Sets pane width in <rn:param>. page 374 
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Examples 
<video src="video.rm” region="video_region”> 
<area href="http://www.example.com/context.html” external="true” rn:sendTo=" 
sourcePlaystate="play”> 
<rm:param name="width” value="320"/> 
<rm:param name="height” value="240"/> 
</area> 
</video> 


7 


_rpcontextwin” 


<video src="video.rm” region="video_region”> 
<area href="rtsp://helixserver.example.com/video2.rm” shape="circle” coords="80,60,30” 
begin="5s" end="45s" show="new” sourcePlaystate="play” destinationPlaystate=" play” /> 
</video> 


Animation Tags 


<animate/> 


The <animate/> tag is the basic animation tag. Other animation tags are variations of 
<animate/>. The targetElement and attributeName attributes are generally required, as well as one 
of the to, by, or values attributes. For more on this tag, see “Creating Basic Animations” on page 
421. 


SMIL 2.0 <animate/> Tag Attributes 


Attribute Value Default Function Reference 

accumulate none|sum none | Makes a repeating animation build with | page 432 
each iteration when set to sum. 

additive replace|sum replace | Adds the animation value to the page 432 
existing attribute value if set to sum. 

attributeName | attribute_name (none) | Selects the attribute to animate. page 422 

begin time_value Os Delays normal playback time. page 314 
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SMIL 2.0 <animate/> Tag Attributes (continued) 


Attribute Value Default Function Reference 
by pixels | percentage | (none) | Animates the element by a certain page 426 
color_value amount. Do not use with to. 
calcMode discrete|linear| linear | Controls the flow of an animation. page 429 
paced 
dur time_value|indefinite | media | Sets the total time the animation or one | page 317 
of its repeating cycles plays. 
end time_value (none) | Sets the end time for the animation. page 314 
fill auto|default|freeze| auto| | Determines the fill state when the page 327 
hold|remove default | animation is no longer active. 
from pixels |percentage | (none) | Sets a starting point for the animation. | page 426 
color_value Use with to or by. 
id name (none) | Names the animation for reference by | page 202 
other elements. 
repeatCount integer |indefinite | 0 Repeats the animation the specified page 323 
fractional_value number of times, or indefinitely. 
repeatDur time_value|indefinite | 0s Repeats the animation the specified page 323 
amount of time. 
restart always|default|never| /always | Determines if the animation can restart. | page 352 
whenNotActive 
targetElement |ID (none) | Identifies the tag that contains the page 422 
animated attribute. 
to pixels | percentage | (none) | Sets an end point for the animation. Do | page 426 
color_value not use with by. 
values pixels |percentage | (none) | Defines a list of values applied to the page 428 
color_value animated attribute. 
(Table Page 2 of 2) 
Examples 


<animate targetElement="video_region” attributeName="width” to="380" dur="3s”"/> 


<animate targetElement="image_region” attributeName="width” dur="2s” by="16” accumulate="sum” 


repeatCount="4”" calcMode="discrete” /> 


577 


RealNetworks Production Guide 


<animateColor/> 


The <animateColor/> tag is similar to <animate/>, but it works for color animations only. The 
targetElement and attributeName attributes are generally required, as well as one of the to, by, or 
values atttributes. For more on this tag, see “Animating Colors” on page 434. 


SMIL 2.0 <animateColor/> Tag Attributes 


Attribute Value Default Function Reference 
attributeName | attribute_name (none) | Selects the attribute to animate. page 422 
begin time_value Os Delays normal playback time. page 314 
by pixels |percentage | (none) | Animates the element by a certain page 426 
color_value amount. Do not use with to. 
calcMode discrete|linear| linear | Controls the flow of an animation. page 429 
paced 
dur time_value|indefinite |media | Sets the total time the animation or one | page 317 
of its repeating cycles plays. 
end time_value (none) | Sets the end time for the animation. page 314 
fill auto|default|freeze| auto| | Determines the fill state when the page 327 
hold|remove default | animation is no longer active. 
from pixels |percentage | (none) | Sets a starting point for the animation. | page 426 
color_value Use with to or by. 
id name (none) | Names the animation for reference by | page 202 
other elements. 
restart always|default|never| | always | Determines if the animation can restart. | page 352 
whenNotActive 
targetElement |ID (none) | Identifies the tag that contains the page 422 
animated attribute. 
to pixels |percentage | (none) | Sets an end point for the animation. Do | page 426 
color_value not use with by. 
values pixels |percentage | (none) | Defines a list of values applied to the page 428 
color_value animated attribute. 
Example 


<animateColor targetElement="image_region" attributeName="backgroundColor" 
values="red;blue;yellow" calcMode="discrete” begin="1s" dur="12s" fill="freeze"/> 
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The <animateMotion/> tag can move an element both horizontally and vertically. The 


APPENDIX D: SMIL Tag Summary 


targetElement attribute is generally required, as well as one of the to, by, or values atttributes. 


For more on this tag, see “Creating Horizontal and Vertical Motion” on page 435. 
g g pag 


SMIL 2.0 <animateMotion/> Tag Attributes 


Attribute Value Default Function Reference 
accumulate none|sum none | Makes a repeating animation build with | page 432 
each iteration when set to sum. 
additive replace|sum replace | Adds the animation value to the page 432 
existing attribute value when set to sum. 
begin time_value Os Delays normal playback time. page 314 
by pixels | percentage | (none) | Animates the element by a certain page 426 
color_value amount. Do not use with to. 
calcMode discrete|linear| paced | Controls the flow of an animation. page 429 
paced 
dur time_value|indefinite media | Sets the total time the animation or one | page 317 
of its repeating cycles plays. 
end time_value (none) | Sets the end time for the animation. page 314 
fill auto|default|freeze| auto| | Determines the fill state when the page 327 
hold|remove default | animation is no longer active. 
from pixels |percentage | (none) | Sets a starting point for the animation. | page 426 
color_value Use with to or by. 
id name (none) | Names the animation for reference by | page 202 
other elements. 
repeatCount integer |indefinite | 0 Repeats the animation the specified page 323 
fractional_value number of times, or indefinitely. 
repeatDur time_value|indefinite | 0s Repeats the animation the specified page 323 
amount of time. 
restart always|default|never| |always | Determines if the animation can restart. | page 352 
whenNotActive 
targetElement |ID (none) | Identifies the tag that contains the page 422 
animated attribute. 
to pixels |percentage | (none) | Sets an end point for the animation. Do | page 426 
color_value not use with by. 
values pixels | percentage | (none) | Defines a list of values applied to the page 428 


color_value 


animated attribute. 
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Example 
<animateMotion targetElement="image_region" values="180,180;60,340;125,95" 
calcMode="discrete" begin="7s" dur="5s" fill="freeze"/> 


<set/> 


The <set/> tag sets an attribute to a specified value. The targetElement, attributeName, and to 
attributes are required. For more on this tag, see “Setting an Attribute Value” on page 436. 


SMIL 2.0 <set/> Tag Attributes 


Attribute Value Default Function Reference 
attributeName | attribute_name (none) | Selects the attribute to animate. page 422 
begin time_value Os Delays normal playback time. page 314 
dur time_value|indefinite | media _| Sets the total time the animation or one | page 317 
of its repeating cycles plays. 
end time_value (none) | Sets the end time for the animation. page 314 
fill auto|default|freeze| auto| | Determines the fill state when the page 327 
hold|remove default | animation is no longer active. 
id name (none) | Names the animation for reference by | page 202 


other elements. 


restart always|default|never| | always | Determines if the animation can restart. | page 352 
whenNotActive 


targetElement |ID (none) | Identifies the tag that contains the page 422 
animated attribute. 


to pixels |percentage | (none) | Sets the attribute value. page 426 
color_value 


Example 
<set targetElement="video_region” attributeName="backgroundColor” to="blue” dur="30s"/> 
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APPENDIX 


E 


Use this appendix for reference when writing RealText files. For complete 


information on RealText, see Chapter 6. The section “Conventions Used in this 


Guide” on page 13 explains the typographical conventions used in this appendix. 


Window Tag Attributes 


The <window> tag that starts each RealText clip can use the attributes specified in the following 


table to set the overall clip parameters. 


RealText <window> Tag Attributes 


Attribute Value Default Function Reference 
bgcolor name|#RRGGBB| black (tickertape) | Sets the window color. page 116 
transparent white (all others) 
crawlrate | pixels_per _second 20 (tickertape) Sets the horizontal text speed. | page 121 
20 (marquee) 
0 (all others) 
duration hh:mmiss.xy 60 seconds Specifies clip length. page 118 
extraspaces | use|ignore use Recognizes or ignores extra page 122 
spaces in text. 
height pixels 30 (tickertape) Sets the window pixel height. | page 116 
30 (marquee) 
180 (all others) 
link name|#RRGGBB blue Specifies the hyperlink color. | page 121 
loop false|true true (tickertape) | Turns text looping on or off. | page 122 
true (marquee) 
false (all others) 
scrollrate | pixels_per __second 10 (scrollingnews) | Sets the vertical text speed. page 121 
0 (all others) 
type generic|tickertape| generic Sets the window type. page 115 
marquee|scrollingnews| 
teleprompter 
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RealText <window> Tag Attributes 


Attribute Value Default Function Reference 
underline | false|true true Determines whether page 121 
_hyperlinks hyperlinks are underlined. 
version 1.0]1.2|1.4]1.5 1.0 Specifies RealText version. page 120 
Required for some character 
sets. 
width pixels 500 (tickertape) Sets the window pixel width. | page 116 
500 (marquee) 
320 (all others) 
wordwrap __| false|true true Turns word wrap on or off. page 121 
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Example 

<window type="scrollingnews” width="218” height="420" bgcolor="green” version="1.5” 
duration="180.5” underline_hyperlinks="false” link="red”> 

...all clip text... 

</window> 


Time and Position Tags 
The tags in the following table let you time and position the text in a RealText clip. 


RealText Time and Position Tags 


Tag Attributes Default Function Reference 
<clear/> (none) (none) | Clears all text from the window. page 125 
<pos/> x=“pixels” |y="pixels” (none) | Positions text. page 126 
<required>... | (none) (none) | Ensures that text is delivered. page 127 
</required> 

<time/> begin="hh:mm:ss.xy”| |(none) | Sets time when text appears or page 123 

end=“hh:mm:ss.xy” disappears. 

<tl>...</tl> color="name|#RRGGBB” |green | Places text at bottom of ticker tape. page 126 
<tu>...</tu> | color="name|#RRGGBB” | white | Places text at top of ticker tape. page 126 
Examples 


<time begin="10"/>Display at 10 seconds after clip starts. 
<time begin="15"/><clear/>Clear previous text and display at 15 seconds after clip starts. 


<tu color="yellow”>DJIA</tu> 
<tl color="blue”>7168.35 +36.52 </tl> 
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Font Tag Attributes 
The <font> tag lets you select fonts and character sets. 


RealText <font> Tag Attributes 


Attribute Value Default Function Reference 
bgcolor name|#RRGGBB transparent | Sets the text background color. | page 134 
charset us-ascii|iso-8859-1| iso-8859-1 | Specifies character set used to | page 128 
mac-roman|x-sjis| display text. 
gb2312|big5|iso-2022-kr 
color name|#RRGGBB (none) Controls font color, except for | page 134 
TickerTape window. 
face (see font tables) Times New | Sets the text face. page 130 
Roman 
size -2|-1|+0|+1]+2|+3|+4 +0 Sets the font size. page 133 
or 
1|2|3|4|5|6|7 
Examples 


<font color="red” bgcolor="green”>This is red text against a green background.</font> 
<font size="+1">This text is one size larger than the preceding text.</font> 

<font face="Verdana”>This text is in the Verdana font.</font> 

<font charset="iso-2022-kr” face="BatangChe”>...Korean text...</font> 


Layout and Appearance Tags 
The following RealText tags affect the layout and appearance of text. 


RealText Layout and Apperance Tags 


Tag Function Reference 
<b>...</b> Bolds the enclosed text. page 137 
<br/> Creates a line break and displays text one line down. page 136 
<center>...</center> | Centers the enclosed text. page 136 
<hr/> Acts like two <br/> tags, but does not create a horizontal rule. page 137 
Provided for HTML compatibility. 
<i>...</i> Italicizes the enclosed text. page 137 
<li>...</li> Acts like a <br/> tag. Provided for HTML compatibility. page 137 
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RealText Layout and Apperance Tags (continued) 


Tag Function Reference 

<ol>...</ol> Indents text, but does not number it. Provided for HTML page 137 
compatibility. 

<p>...</p> Creates a text paragraph. page 136 

<pre>...</pre> Displays text in a monospace font and preserves extra spaces. Works | page 136 
the same as in HTML. 

<S>...</S> Strikesthrough the enclosed text. page 137 

<u>...</U> Underlines the enclosed text. page 137 

<ul>...</ul> Indents text, but does not add bullets to it. Provided for HTML page 137 
compatibility. 
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Examples 
<center>This is centered text.</center> 


This is <b>bolded</b> text. 


This is <u>underlined</u> text. 


Hyperlinking Commands 


You can use <a> and </a> tags to create a link out of enclosed text. The link can open a URL in 
RealOne Player or the viewer’s browser, open an e-mail message, or issue a RealOne Player 


command. 
RealText <a> Tag Attributes 
Attribute Value Function Reference 
href=“command” target="_player” | command:seek(time)| | Creates hyperlink that issues a | page 140 
command:pause()| command. 
command:play() 
href=“command:openwindow()” =| name|URL| Opens new, named media page 383 
zoomlevel windows for the URL. 
href=“mailto:address” email_address Opens e-mail message. page 138 
href=“URL” target="_player” Creates hyperlink to URL. page 138 
Examples 


<a href=“mailto:a@b.com”>send e-mail</a> 
<a href=“rtsp://helixserver.example.com/video2.smil target=”"_player”>Play Next Clip</a> 
<a href=“http://realguide.real.com”>Visit RealGuide</a> 


<a href="aim:goim?screenname=[name]”>Send Me an Instant Message</a> 
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<a href="command:seek(1:35.4)” target="_player”>Seek</a> 
<a href="command:play()” target=”"_player”>Play</a> 


<a href="command:openwindow(feature, rtsp://helixserver.example.com/comedy.rm, 
zoomlevel=double)”>Comedy Hour</a> 
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REALPIX TAG SUMMARY 


This appendix serves as a quick reference for RealPix markup. For complete 
information on RealPix, see Chapter 7. The section “Conventions Used in this 
Guide” on page 13 explains the typographical conventions used in this appendix. 


In the following tables, an asterisk (*) indicates a required attribute. 


<imfl>...</imfl> 


The RealPix markup starts with <imfl> and ends with </imfl>. All RealPix markup must occur 
between these tags. For more information, see “Structure of a RealPix File” on page 152. 


<head/> 


The <head/> tag comes just after the opening <imfl> tag, defining overall presentation settings, 
such as the streaming bit rate and the duration. Unlike the <head> tags in RealText and SMIL, 
the RealPix <head/> tag closes with a slash, and does not use a corresponding end tag. See 
“Setting Slideshow Characteristics” on page 158 for more on the <head/> tag. 


RealPix <head/> Tag Attributes 


Attribute Value Default Function Reference 
aspect false|true true Handles image aspect ratios. page 163 
author text (none) Gives the name of the author. page 161 
background-color |name|#RRGGBB | black Sets an initial background color. page 161 
bitrate* bits_per_second | (none) Indicates required bandwidth. page 161 
copyright text (none) Gives the copyright notice. page 161 
duration* time_value (none) Sets the presentation duration. page 160 
height* pixels (none) Specifies the presentation height. page 159 
maxfps integer (calculated) | Sets the maximum effect frame rate. | page 164 
preroll seconds (calculated) | Allots time for initial buffering. page 162 
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RealPix <head/> Tag Attributes (continued) 


Attribute Value Default Function Reference 
timeformat milliseconds| milliseconds | Indicates the format of time page 159 
dd:hh:mm:ss.xyz attributes. 
title text (none) Gives the presentation title. page 161 
url URL (none) Sets a hyperlink URL for images. page 163 
width* pixels (none) Specifies the presentation width. page 159 
(Table Page 2 of 2) 
<image/> 


The <image/> tags appear after the <head/> tag. Each tag specifies an image URL, and assigns 
the image a handle. For more on <image/>, see “Defining Images” on page 165. 


RealPix <image/> Tag Attributes 


Attribute Value Default Function Reference 
handle* | integer (none) Sets an ID that effect tags use to select animage. | page 165 
name* | file_name | (none) Gives the file name and path. page 166 
size bytes (none) Indicates the file size for Web server delivery. page 166 
mime mime_type | (none) Specifies a mime type for Web server delivery. page 167 
<animate/> 


The <animate/> tag starts an animated GIF cycling through its frames. For more information, 


see “Controlling an Animated GIF Image” on page 175. 


RealPix <animate/> Tag Attributes 


Attribute Value Default Function Reference 
aspect false|true set in <head/> | Keeps or ignores the image aspect ratio. page 170 
dsth pixels height value | Specifies the height of the destination rectangle. | page 179 
dstw pixels width value Specifies the width of the destination rectangle. | page 179 
dstx pixels 0 Sets x-coordinate of the destination rectangle. page 179 
dsty pixels 0 Sets y-coordinate of the destination rectangle. page 179 
duration* |time_value | (none) Specifies the effect’s duration. page 168 
maxfps integer set in <head/> | Controls the maximum animation frame rate. page 170 
srch pixels image height | Specifies the height of the source rectangle. page 179 
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RealPix <animate/> Tag Attributes (continued) 
Attribute Value Default Function Reference 
srcw pixels image width | Specifies the width of the source rectangle. page 179 
STcx pixels 0 Sets the x-coordinate of the source rectangle. page 179 
srcy pixels 0 Sets the y-coordinate of the source rectangle. page 179 
start* time_value | (none) Gives the effect’s starting time. page 168 
target* handle (none) Indicates the image used for the effect. page 169 
url URL set in <head/> | Sets a link URL while the effect is active. page 169 
(Table Page 2 of 2) 
<crossfade/> 


The <crossfade/> tag fades a new image into an existing one. For more information, see 
“Crossfading One Image Into Another” on page 172. 


RealPix <crossfade/> Tag Attributes 


Attribute Value Default Function Reference 
aspect false|true set in <head/> | Keeps or ignores the image aspect ratio. page 170 
dsth pixels height value | Specifies the height of the destination rectangle. | page 179 
dstw pixels width value Specifies the width of the destination rectangle. | page 179 
dstx pixels 0 Sets x-coordinate of the destination rectangle. page 179 
dsty pixels 0 Sets y-coordinate of the destination rectangle. page 179 
duration* |time_value | (none) Specifies the effect’s duration. page 168 
maxfps integer set in<head/> | Controls the maximum frame rate. page 170 
srch pixels image height | Specifies the height of the source rectangle. page 179 
sTcW pixels image width | Specifies the width of the source rectangle. page 179 
STCx pixels 0 Sets the x-coordinate of the source rectangle. page 179 
srcy pixels 0 Sets the y-coordinate of the source rectangle. page 179 
start* time_value | (none) Gives the effect’s starting time. page 168 
target* handle (none) Indicates the image used for the effect. page 169 
url URL set in <head/> | Sets a link URL while the effect is active. page 169 
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<fadein/> 


The <fadein/> tag fades an image into the display area. For more information, see “Fading In on 


an Image” on page 171. 


RealPix <fadein/> Tag Attributes 


Attribute Value Default Function Reference 
aspect false|true set in <head/> | Keeps or ignores the image aspect ratio. page 170 
dsth pixels height value | Specifies the height of the destination rectangle. | page 179 
dstw pixels width value Specifies the width of the destination rectangle. | page 179 
dstx pixels 0 Sets x-coordinate of the destination rectangle. page 179 
dsty pixels 0 Sets y-coordinate of the destination rectangle. | page 179 
duration* |time_value | (none) Specifies the effect’s duration. page 168 
maxfps integer set in <head/> | Controls the maximum frame rate. page 170 
srch pixels image height | Specifies the height of the source rectangle. page 179 
sTcw pixels image width | Specifies the width of the source rectangle. page 179 
STcx pixels 0 Sets the x-coordinate of the source rectangle. page 179 
srcy pixels 0 Sets the y-coordinate of the source rectangle. page 179 
start* time_value | (none) Gives the effect’s starting time. page 168 
target* handle (none) Indicates the image used for the effect. page 169 
url URL set in <head/> | Sets a link URL while the effect is active. page 169 
<fadeout/> 


The <fadeout/> tag fades the display area into a solid color. For more information, see “Fading 


an Image Out to a Color” on page 172. 


RealPix <fadeout/> Tag Attributes 


Attribute Value Default Function Reference 
color* name| (none) Sets the fadeout color. page 553 
#RRGGBB 
dsth pixels height value | Specifies the height of the destination rectangle. | page 179 
dstw pixels width value Specifies the width of the destination rectangle. page 179 
dstx pixels 0 Sets the x-coordinate of the destination rectangle. | page 179 
dsty pixels 0 Sets the y-coordinate of the destination rectangle. | page 179 
duration* | time_value | (none) Specifies the effect’s duration. page 168 
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APPENDIX F: RealPix Tag Summary 


RealPix <fadeout/> Tag Attributes (continued) 


Attribute Value Default Function Reference 


integer set in <head/> | Controls the maximum frame rate. 
time_value Gives the effect’s starting time. page 168 


(Table Page 2 of 2) 


start* 


<fill/> 


The <fill/> tag paints a color rectangle over the display area. For more information, see 
“Painting a Color Fill” on page 173. 


RealPix <fill/> Tag Attributes 


Attribute Value Default Function Reference 
color* name| (none) Sets the fill color. page 553 
#RRGGBB 

dsth pixels height value | Specifies the height of the destination rectangle. | page 179 

dstw pixels width value | Specifies the width of the destination rectangle. | page 179 

dstx pixels 0 Sets the x-coordinate of the destination rectangle. | page 179 

dsty pixels 0 Sets the y-coordinate of the destination rectangle. | page 179 

start* time_value _| (none) Gives the effect start time. page 168 

<wipe/> 


The <wipe/> tag introduces a new image with one of several wipe transition effects. For more 
information, see “Creating a Wipe Effect” on page 174. 


RealPix <wipe/> Tag Attributes 


Attribute Value Default Function Reference 
aspect false|true set in<head/> | Keeps or ignores the image aspect ratio. page 170 
direction* |left|right| (none) Sets the wipe effect direction. page 175 
up|down 
dsth pixels height value | Specifies height of the destination rectangle. | page 179 
dstw pixels width value Specifies width of the destination rectangle. | page 179 
dstx pixels 0 Sets x-coordinate of the destination rectangle. | page 179 
dsty pixels 0 Sets y-coordinate of the destination rectangle. | page 179 
duration* |time_value | (none) Specifies the effect’s duration. page 168 


(Table Page 1 of 2) 
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RealPix <wipe/> Tag Attributes (continued) 


Attribute Value Default Function Reference 
maxfps integer set in <head/> | Controls the maximum frame rate. page 170 
srch pixels image height | Specifies the height of the source rectangle. | page 179 
srcw pixels image width | Specifies the width of the source rectangle. page 179 
STCX pixels 0 Sets the x-coordinate of the source rectangle. | page 179 
srcy pixels 0 Sets the y-coordinate of the source rectangle. | page 179 
start* time_value _| (none) Gives the effect’s starting time. page 168 
target* handle (none) Indicates the image used for the effect. page 169 
type* normal|push | (none) Specifies the type of wipe effect. page 175 
url URL set in <head/> | Sets a link URL while the effect is active. page 169 
(Table Page 2 of 2) 
<viewchange/> 


The <viewchange/> tag lets you zoom in or out on an image, as well as pan across an image. For 
more information, see “Zooming In, Zooming Out, and Panning” on page 176. 


RealPix <viewchange/> Tag Attributes 


Attribute Value Default Function Reference 
dsth pixels height value | Specifies the height of the destination page 179 
rectangle. 
dstw pixels width value Specifies the width of the destination rectangle. | page 179 
dstx pixels 0 Sets x-coordinate of the destination rectangle. | page 179 
dsty pixels 0 Sets y-coordinate of the destination rectangle. | page 179 
duration* |time_value | (none) Specifies the effect’s duration. page 168 
maxfps integer set in <head/> | Controls the maximum frame rate. page 170 
srch pixels image height | Specifies the height of the source rectangle. page 179 
srcw pixels image width Specifies the width of the source rectangle. page 179 
STCXx pixels 0 Sets the x-coordinate of the source rectangle. page 179 
srcy pixels 0 Sets the y-coordinate of the source rectangle. page 179 
start* time_value | (none) Gives the effect’s starting time. page 168 


592 


APPENDIX 


G 


RAM FILE SUMMARY 


This appendix summarizes Ram file parameters, which are described in the section 
“Passing Parameters Through a Ram File” on page 510. Be sure to familiarize 
yourself with “Conventions Used in this Guide” on page 13, which explains the 
typographical conventions used in this appendix. 


Parameter Syntax 


A Ram file is plain text file that uses the file extension .ram. Each line holds the full URL to a 
clip or SMIL presentation, and can include parameters that affect playback. Separate the first 
parameter from the URL with a question mark (?), as shown here: 


rtsp://helixserver.example.com/videol.rm?parameter=value 


To set two or more parameters for the same clip, precede the second and all subsequent 
P : 
parameters with ampersands (&) instead of question marks: 


rtsp://helixserver.example.com/videol.rm?parameter=value&parameter=value&parameter=value... 


Parameters and Values 


Ram File Parameters and Values 


Parameter Value Default Function Reference 
author text (none) Indicates the clip author. page 516 
clipinfo title=text| (none) Gives extended clip information. page 517 


artist name=text| 
album name=text| 
genre=text| 
copyright=text| 
year=text| 
cdnum=number| 
comments=text 


copyright text (none) Gives the copyright notice page 516 
(Table Page 1 of 2) 
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Ram File Parameters and Values (continued) 


Parameter Value Default Function Reference 
end hh:mmiss.x (none) Ends the clip at the specified point. | page 515 
mode normal|theater| normal Opens RealOne Player in one of three | page 514 
toolbar initial playback modes. 
rpcontextheight | pixels media height | Sets the related info pane’s height. _| page S11 
rpcontextparams | parameters (none) Adds parameters to rpcontexturl. page 512 
rpcontexttime dd:hh:mm:ss.x 0 Specifies a time at which an HTML | page 512 
page displays in the related info pane. 
rpcontexturl URL|_keep (none) Displays the specified URL in the page 511 
related info pane. 
rpcontextwidth | pixels 330 Sets the related info pane width. page S11 
rpurl URL (none) Gives a URL for the media browser. | page 512 
rpurlparams parameters (none) Appends parameters to rpurl. page 512 
rpurltarget _tpbrowser|name_ |_rpbrowser Sets the target for rpurl as the media | page 512 
browser pane or a secondary window. 
rpvideofillcolor | color_value black Sets the media playback pane color. | page 512 
screensize double|full| original Sets the size at which the clip or page 514 
original presentation opens. 
start hh:mmiss.x 0 Starts the clip at the specified point. | page 515 
title text (none) Specifies the clip title. page 516 
(Table Page 2 of 2) 
Examples 


rtsp://helixserver.example.com/videol.rm?rpcontextheight=250 
&rpcontextwidth=280&rpcontexturl="http://www.example.com/relatedinfo1.html” 


rtsp://helixserver.example.com/video2.rm?rpurl="http://www.example.com/index.html” 


rtsp://helixserver.example.com/sample1.smil?screensize=full 


rtsp://helixserver.example.com/audio1.rm?start=55&end=1:25 


rtsp://helixserver.example.com/introvid.rm?title="Introduction to Streaming Media 
Production" &author="RealNetworks, Inc."&copyright="&#169;2001, RealNetworks, Inc." 
rtsp://helixserver.example.com/song1.rm?clipinfo="title=Artist of the Year|artist name=Your Name 
Here|album name=My Debut|genre=Rock|copyright=2001|year=2001|comments=This one really 
knows how to rock!" 
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APPENDIX 


la 


The following tables summarize the file types commonly streamed 
to RealOne Player. This is not a definitive list of all file types, 
though. Plug-in technology allows RealOne Player to play virtually 


any file type. 


RealOne Player Standard Streaming Clip Types 


Extension File Type Reference 
.rm or .ra | RealAudio page 59 
rm RealVideo page 73 
.tmvb RealVideo variable bit rate page 89 
.rp RealPix streaming image markup page 147 
att RealText streaming text page 111 
swf Flash Player file page 91 
RealOne Player Information Files 
Extension _ File Type Reference 
ram Ram file to launch RealOne Player page 507 
.tpm Ram file for embedded presentations page 483 
.smil,.smi | SMIL file for layout and timing page 197 
Image Files Types Playable Directly in RealOne Player and RealPix 
Extension File Type Reference 
gif GIF87, GIF89, or animated GIF image page 42 
jpg, jpeg |JPEG (nonprogressive ) image page 42 
-png PNG image page 42 
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LANGUAGE CODES 


APPENDIX 


As “Switching Between Language Choices” on page 443 explains, SMIL can list 


different language choices that RealOne Player chooses from based on its language 


preference. The following table lists the codes you can use in a SMIL file to indicate 


clips created for specific languages. 


Code Language 

af Afrikaans 

sq Albanian 

ar-iq Arabic ( Iraq) 
ar-dz Arabic (Algeria) 
ar-bh Arabic (Bahrain) 
ar-eg Arabic (Egypt) 
ar-jo Arabic (Jordan) 
ar-kw Arabic (Kuwait) 
ar-lb Arabic (Lebanon) 
ar-ly Arabic (Libya) 
ar-ma Arabic (Morocco) 
ar-om Arabic (Oman) 
ar-qa Arabic (Qatar) 
ar-sa Arabic (Saudi Arabia) 
ar-sy Arabic (Syria) 
ar-tn Arabic (Tunisia) 
ar-ae Arabic (U.A.E.) 
ar-ye Arabic (Yemen) 
eu Basque 

bg Bulgarian 


Code Language 

ca Catalan 

zh-hk Chinese (Hong Kong) 
zh-cn Chinese (People’s Republic) 
zh-sg Chinese (Singapore) 
zh-tw Chinese (Taiwan) 

hr Croatian 

cs Czech 

da Danish 

nl Dutch (Standard) 
nl-be Dutch (Belgian) 

en English 

en-au English (Australian) 
en-bz English (Belize) 

en-gb English (British) 
en-ca English (Canadian) 

en English (Caribbean) 
en-ie English (Ireland) 
en-jm English (Jamaica) 
en-nz English (New Zealand) 
en-za English (South Africa) 
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Code Language 

en-tt English (Trinidad) 
en-us English (United States) 
et Estonian 

fo Faeroese 

fi Finnish 

fr-be French (Belgian) 

fr-ca French (Canadian) 
fr-lu French (Luxembourg) 
fr French (Standard) 
fr-ch French (Swiss) 

de-at German (Austrian) 
de-li German (Liechtenstein) 
de-lu German (Luxembourg) 
de German (Standard) 
de-ch German (Swiss) 

el Greek 

he Hebrew 

hu Hungarian 

is Icelandic 

in Indonesian 

it Italian (Standard) 
it-ch Italian (Swiss) 

ja Japanese 

ko Korean 

ko Korean (Johab) 

lv Latvian 

lt Lithuanian 

no Norwegian 

pl Polish 

pt-br Portuguese (Brazilian) 
pt Portuguese (Standard) 
ro Romanian 
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Code Language 

st Serbian 

sk Slovak 

sl Slovenian 

es-ar Spanish (Argentina) 
es-bo Spanish (Bolivia) 
es-cl Spanish (Chile) 

eS-CO Spanish (Colombia) 
es-cr Spanish (Costa Rica) 
es-do Spanish (Dominican Republic) 
es-eCc Spanish (Ecuador) 
eS-SV Spanish (El Salvador) 
es-gt Spanish (Guatemala) 
es-hn Spanish (Honduras) 
es-mx Spanish (Mexican) 
es-ni Spanish (Nicaragua) 
eS-pa Spanish (Panama) 
es-py Spanish (Paraguay) 
es-pe Spanish (Peru) 

es-pr Spanish (Puerto Rico) 
es Spanish (Spain) 
es-uy Spanish (Uruguay) 
es-ve Spanish (Venezuela) 
sv Swedish 

sv-fi Swedish (Finland) 

th Thai 

tr Turkish 

uk Ukrainian 

vi Vietnamese 


GLOSSARY 


Advertising Application 
A Helix Universal Server option that inserts ads into SMIL-based 
presentations. SMIL files use <RealAdInsert/> tags to indicate ad 
placement. 


artifact 
A visual imperfection in an encoded video clip. Too many artifacts can 


make the video look blocky. 


bandwidth 
The upper limit on the amount of data, typically expressed as Kilobits per 
second (Kbps), that can pass through a network connection. 

banner ad 
An ad that appears alongside a requested clip or presentation. A banner ad 
can also rotate, making new ad images appear at regular intervals. 

binary tag 
A SMIL tag that comprises opening and closing tags, such as <ref> and 
</ref>. Many unary tags can become binary tags when necessary to enclose 
other tags. 

bit 
The smallest unit of measure of data in a computer. A bit has a binary 
value, either 0 or 1. 

bit rate 
A measure of bandwidth, expressed as the number of bits transmitted per 
second. A 28.8 Kbps modem, for example, can transmit or receive around 
29,000 bits per second. 

blank time 
A period during a presentation in which RealOne Player is not paused, but 
no activity occurs onscreen. You typically insert blank time with the SMIL 
begin attribute. 
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broadcast 
To deliver a presentation, whether live or prerecorded, in which all viewers 


join the presentation in progress. Contrast to on-demand. 


buffering 
The receiving and storing of data before it is played back. A clip’s initial 
buffering is called preroll. After this preroll, excessive buffering may stall 
the presentation. 

byte 
A common measurement of data. One byte consists of 8 bits. 


cable modems 
Devices that allow rapid transmission and reception of data over 


television cable. They are digital devices, unlike dial-up modems, which 
transmit analog data. 
camel case 
A capitalization convention in which words in a phrase are joined, and 
each word after the first begins with a capital letter. SMIL 2.0 attributes 
and values generally use camel case, as in soundLevel or whenNotActive. 
CBR 
Constant Bit Rate. A type of RealVideo encoding in which all parts of the 
video play back at the same bit rate. Contrast to VBR. 


CHTTP 
A version of HTTP supported by RealOne Player. Files designated with 


chttp:// are downloaded through HTTP and stored in RealOne Player’s 
cache. 
client 
A software application that receives data from a server. A Web browser is a 
client of a Web server. RealOne Player is a client of Helix Universal Server. 
clip 
A media file within a presentation. Clips typically have an internal 
timeline, as with RealAudio and RealVideo. 


codec 
Coder/decoder. Codecs convert data between uncompressed and 


compressed formats, reducing the bandwidth a clip consumes. 


Glossary 


download 
To send a file over a network with a nonstreaming protocol such as HTTP. 


Contrast to stream. 
DSL 
Digital Subscriber Line. A technology for transmitting digital data over a 
regular telephone line much faster than through dial-up modems. 
duress stream 
A low-bandwidth SureStream audio or video stream that Helix Universal 
Server uses if a connection’s available bandwidth drops greatly. 


encoding 
Converting a file into a compressed, streaming format. For example, you 


can encode WAV files as RealAudio clips. 


Flash 
A software application and an animation format created by Macromedia. 


RealOne Player can play Flash animations and stream them in parallel 
with other clips, such as RealAudio clips. 

Flash Player file 
A compressed Flash file format (file extension .swf) suitable for streaming. 
To stream Flash, you export the Flash Player file and tune it so that it 
plays well in RealOne Player. 

fps 
Frames Per Second. The number of video frames that displays each second 
in a streaming video clip. 

frequency response 
A measure of audio clip quality. The higher a clip’s frequency response, 
the more frequencies it can faithfully reproduce. 


Helix Producer 
The primary RealNetworks tool for encoding RealAudio and RealVideo 


clips. 


Helix Universal Server 
RealNetworks server software used to stream multimedia presentations to 


RealOne Player. 


Helix Universal Server administrator 
The person in charge of setting up and running Helix Universal Server. 
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HTTP 
Hypertext Transport Protocol. The protocol used by Web servers to 
communicate with Web browsers. In contrast, Helix Universal Server 
streams clips to RealOne Player with RTSP. See also CHTTP. 


inline switching 
Switching between alternative clips without using a SMIL <switch> tag. 
interstitial ad 
An advertisement that interrupts playback of a requested clip. It is like a 
commercial break on television. 


ISDN 
Integrated Services Digital Network. Technology that makes digital data 
connections at 64 or 112 Kbps possible over telephone lines. 

ISP 
Internet Service Provider. A company that provides access to the Internet. 
Many ISPs have Helix Universal Server available to stream media clips. 


kilobit (Kb) 
A common unit of data measurement equal to 1024 bits. A kilobit is 
usually referred to in the context of bit rate per unit of time, such as 
Kilobits per second (Kbps). 

kilobyte (KKB) 
A common unit of data measurement equal to 1024 bytes or 8 Kilobits. 


LAN 
Local Area Network. A computer network confined to a local area, such as 
a single building. LANs vary in speed, with bandwidth shared among all 
networked devices. 

lossy 
A compression scheme that lowers clip size by discarding nonessential 
data from the source file. Both RealAudio and RealVideo are lossy. 


metafile 
Another name for a Ram file. 


mouseover 
The action of moving a computer screen pointer over an interactive area. 


An animated button may change appearance on a mouseover, for example. 


Glossary 


namespace 
An XML declaration that identifies the features used in a SMIL 
presentation. For SMIL 2.0 and higher, the <smil> tag must declare a 
namespace. 


on-demand 
A type of streaming in which a clip plays from start to finish when a user 
clicks a link. Most clips are streamed this way. Contrast to broadcast. 


PNA 
A proprietary protocol Helix Universal Server uses for backward 
compatibility with RealPlayer 3 through 5. URLs using PNA start with 
pnm://. 

port 
A connection to a server, designated by a number such as 8080. Helix 
Universal Server uses different ports for the RTSP, HTTP, and PNA 
protocols. 


prefetch 
To stream clip data to RealOne Player before the clip plays back. A clip’s 
preroll can be prefetched minutes before the clip plays, for example, 
masking the preroll from the viewer. 


preroll 
Buffering that occurs just before a clip plays back. Preroll should be no 
more than 15 seconds. 


presentation 
A group of clips coordinated through SMIL and streamed from Helix 
Universal Server to RealOne Player. 


Ram file 
A text file that uses the file extension .ram or .rpm. It launches RealOne 
Player and gives it the URL to a streaming clip or presentation. 

RDT 
RealNetworks Data Transport. The proprietary data package Helix 
Universal Server uses (along with RTSP) when communicating with 
RealOne Player. Contrast to RTP. 
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RealAudio 
A RealText clip type for streaming audio over a network. RealAudio clips 


use the .rm extension. 


RealOne Player 
The successor to RealPlayer 8, RealOne Player combines streaming and 


digital download technologies. It supports the SMIL 2.0 and 1.0 
standards. 

RealPix 
A RealText clip type (file extension .rp) for streaming still images over a 
network. RealPix uses a markup language for creating special effects such 
as fades and zooms. 


RealPlayer G2 
The RealNetworks client software that introduced plug-ins and the ability 


to update itself: It, along with the later RealPlayer 7 and RealPlayer 8, 
supports the SMIL 1.0 standard. 


RealSlideshow 
A RealNetworks tool for creating streaming slideshows based on the 


RealPix markup. 


RealText 
A RealText clip type (file extension .rt) for streaming text over a network. 


It uses a markup language for formatting text. 

real-time 
Delivered as it occurs. For example, a live event is streamed across a 
network in a real-time broadcast. 


RealVideo 
A RealText clip type for streaming video over a network. RealVideo clips 


use the extension .rm. 


rebuffering 
An undesirable state in which RealOne Player must pause a presentation 


to wait for streaming data to arrive. Rebuffering can result from network 
conditions, or a poorly produced presentation. 


rotating banner ads 
Banner advertisements that change at a specified interval, such as a new 


ad banner every 30 seconds. 


Glossary 


RTP 
Real-Time Transport Protocol. The open, standards-based data package 


Helix Universal Server uses (along with RTSP) to communicate with RTP- 
based clients. Contrast to RDT. 

RTSP 
Real-Time Streaming Protocol. An open, standards-based control protocol 
that Helix Universal Server uses to stream clips to RealOne Player or any 
RTP-based client. Contrast to HTTP. 


server 
1. A software application, such as a Web server or Helix Universal Server, 


that sends requested data over a network. 


2. A computer that runs server software. 


Shockwave Flash 
See Flash Player file. 


SMIL 
Synchronized Multimedia Integration Language. A markup language for 
specifying how and when each clip plays within a presentation. SMIL files 
use the extension .smil. 

stream 
1. To send a media clip over a network so that it begins playing back as 
quickly as possible. 
2. A flow of a single type of data, measured in Kilobits per second (Kbps). 
A RealVideo clip’s soundtrack is one stream, for example. 

SureStream 
A RealNetworks technology that enables a RealAudio or RealVideo clip to 
stream at multiple bit rates. 


unary tag 
A SMIL tag that includes a closing slash, as in <ref/>. Many unary tags can 


become binary tags when necessary to enclose other tags. 

URL 
Uniform Resource Locator. A location description that enables a Web 
browser or RealOne Player to receive a clip stored on a Web server or Helix 
Universal Server. 
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Vv VBR 
Variable Bit Rate. A type of RealVideo encoding that enables RealOne 


Player to play different parts of the video at different bit rates, even 
though the video is streamed at a constant rate. Contrast to CBR. 


X XML 


Extensible Markup Language. The parent language for SMIL. XML allows 
one to develop flexible, standardized languages for any purpose. 
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A <a> tag, 360 

<a> tag in RealText, 138 
abstract attribute, 238 
access keys 

for clip timing, 349 

for hyperlinks, 368 
accessibility features 

alternate description, 242 

audio descriptions, 448 

long description, 242 

read order indexing, 243 

system captions, 448 
accesskey attribute 

clip timing, 349 

hyperlinks, 368 
accumulate attribute, 432 
activateEvent value, 346 
ActiveX control, 482 

basics of using, 487 

class ID, 487 

object ID, 487 

scripting, 39 
actuate attribute, 369 
additive attribute, 432 
advertising on RealGuide, 527 
AIFF conversion to RealAudio, 71 
alt attribute 

clips, 242 

hyperlinks, 370 
<animate/> tag, 421 
<animate/> tag in RealPix, 175 
<animateColor/> tag 

compared to <animate/>, 418 

using, 434 
animated GIFs 

in RealPix, 175 


SMIL timing overrides, 325 
<animateMotion/> tag 
compared to <animate/>, 418 
using, 435 
animation 
Scalable Vector Graphics, 42 
see Flash 
see SMIL animation 
<animation/> tag, 209 
<area/> tag, 360 
attributeName attribute, 422 
AU conversion to RealAudio, 71 
audio 
cables, 68 
capture cards, 40 
DC offset, 69 
digitizing, 69 
dynamics compression, 70 
editing programs, 40 
equipment quality, 68 
for Flash, 96 
frequency equalization, 70 
gain compression, 68 
input levels, 68 
normalization, 70 
optimizing, 69 
production tools, 40 
recording tips, 67 
sampling width, 69 
signal-to-noise ratio, 68 
source media, 67 
streaming steps, 65 
volume control in regions 
example, 305 
setting, 292 
see also RealAudio 
audio descriptions, 448 
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<audio/> tag, 209 
audio-only visualizations, 33 
author attribute 

in Ram file, 516, 517 

in RealPix, 161 

in SMIL, 238 
Authoring Kit, 25 
autoupdate of RealOne Player, 43 
AVI 

compressed, 84 

converting to RealVideo, 86 


<b> tag in RealText, 137 
backgroundColor attribute 
animating, 423, 425 
clip source tag, 294 
regions, 290 
see also regions 
backgroundOpacity attribute 
animating, 425 
using, 223 
backward compatibility 
RealOne Player clip support, 43 
through Ram file, 508 
through Ramgen, 522 
through SMIL, 454 
bandwidth 
clip characteristics 
Flash, 92 
images, 210 
RealAudio, 60 
RealPix, 154 
RealText, 113 
RealVideo, 73 
SMIL, 49 
leaving for other processes, 48 
multiclip presentations, 48 
negotiation, 50 
network connection speeds, 47 
overview, 45 
preroll, 46 
rebuffering, 46 
repeating clips, 325 
SMIL switching, 446 
SureStream clips, 50, 447 


switching, 447 

timeline considerations, 53 
bandwidth attribute, 469 
begin attribute 

in clips, 315 

in groups, 315 

in hyperlinks, 361 
beginEvent value, 343 
Betacam video, 82 
bit rate, see bandwidth 
bitrate parameter, 211 
borderColor attribute, 410 
borderWidth attribute, 410 
bottom attribute 

<region/> tag, 281 

<regPoint/> tag, 298 

animating, 423, 425 

clip source tag, 294 
<br/> tag in RealText, 136 
broadcasting 

audio volumes, 68 

RealGuide listings, 527 

RealPix, 153 

RealText, 114 

stream synchronization, 352 
<brush/> tag, 213 
by attribute, 427 


cable modem bandwidth targets, 47 
cable shielding, 68 
caching 
authoring example, 220 
cache directory, 221 
cache size, 221 
CHTTP protocol, 219 
control commands, 221 
expiration rules, 221 
overriding, 221 
requirements, 219 
calcMode attribute, 429 
camel case, 200 
captions 
compared to subtitles, 460 
filler clip, 461 


Index 


RealOne Player preference for, 448 colors 

resizing for captions off, 462 animating, 434 
capture cards, 40 hexadecimal values, 554 
<center> tag in RealText, 136 six-digit, 554 


three-digit, 554 


centering clips in regions 
mixing RGB and hexadecimal values, 556 


example, 304 


through clip source tag, 297 Hames, 553 
with registration point, 300 RealPix 
character sets for RealText, 128 background, 161 
fill, 173 


chromaKey attribute, 224 
chromaKeyOpacity attribute, 225 
chromaKeyTolerance attribute, 225 


RealText, 133 
region backgrounds, 290 
RGB values, 555 


CHTTP, 219 percentages, 555 
<clear/> tag in RealText, 125 pixels, 555 
clicking a clip to start or stop another clip, compression 
346 audio dynamics, 70 
clip information, 238 overview, 41 
clip position and fit, 271 RealAudio, 59 
clip source tags RealVideo, 73 
clip type indicators, 209 context pane, see related info pane 
IDs, 210 contextWindow attribute, 374 
linking coords attribute, 361 
absolute file syntax, 216 copyright attribute 
base target, 217 in Ram file, 516, 517 
Helix Server, 218 in RealPix, 161 
local files, 216 in SMIL, 238 


relative file syntax, 216 
Web server, 219 
Ram file as a clip, 213 
SMIL file as a clip, 214 
layouts, 215 
timing, 215 
clipBegin attribute, 316 
clipEnd attribute, 316 
clipinfo parameter, 517 


copyright protection, 532 
with Helix Server, 45 
with Web server, 524 
CPU 
guidelines, 527 
switching, 449 
<crossfade/> tag in RealPix, 172 
CSS2 standard 
: color values, 553 
clock wipes, 399 SMIL positioning similarities, 282 
close attribute, 277 
codecs D 
see RealVideo 
see RealAudio 
color attribute 
animating, 425 
in <brush/> tag, 213 
color depth switching, 452 


de-interlace filter, 88 

delivery parameter, 211 
destinationLevel attribute, 382 
destinationPlaystate attribute, 377 
digital rights management, 6, 532 
digital video formats, 82 
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direction attribute, 407 
documentation library, 13 
double-size mode 

overview, 34 
doubling clip sizes, 514 
download icon for RealOne Player, 528 
downloading 

RealOne Player plug-ins, 43 

versus streaming, 505 
DSL bandwidth targets, 47 
dur attribute, 317 

in repeating clip, 324 

in transition effects, 407 


edge wipes, 394 

<EMBED> tag, 483 

embedded playback 
ActiveX control, 487 
aspect ratio, 498 
automatic playback, 500 
background color, 497 
backwards compatibility, 489 
basics, 483 
centering clip, 498 


compared to three-pane environment, 


479 
consoles, 495 
image window, 489 
laying out presentations, 501 
local file links, 484 
logo suppression, 499 
looping playback 
indefinitely, 500 
specific number of times, 501 
nonembedded links, 487 
parameters 
AUTOSTART, 500 
BACKGROUNDCOLOR, 497 
CENTER, 498 
CONSOLE, 495 
CONTROLS, 489 
HEIGHT, 486 
LOOP, 500 
MAINTAINASPECT, 498 
NOJAVA, 486 


NOLOGO, 499 
NUMLOOP, 501 
REGION, 502 
SHUFFLE, 501 
SRC, 483 
WIDTH, 486 
RealOne Player controls 
adding to page, 489 
linking multiple controls, 495 
shuffling playback, 501 
size parameters 
percentages, 486 
pixels, 486 
source parameter, 483, 488 
supported browsers, 481 
URL handling, 486 
using in Web page, 479 
encoding tools, see Helix Producer 
end attribute 
in clips, 315 
in groups, 315 
in hyperlinks, 361 
in repeating clip, 324 
endEvent value, 343 
endsync attribute, 320 
erase attribute, 330 
error correction, 89 
escape codes, 518 
example files, 12 
<excl> tag, 259 
exclusive groups 
begin and end times, 315 
clip interruption, 260 
defining, 259 
durations, 319 
fill period 
clip fills, 330 
group default, 334 
group fills, 332 
group inheritance, 335 
interactive timing, 259 
priority classes 
clips with no priority class, 265 
defining, 261 
effect on timing, 265 


higher class interaction, 263 
lower class interaction, 263 
nesting, 265 
peer interaction, 262 
switching, 443 
extension list, 595 
external attribute, 372 


fade effects, 405 
fadeColor attribute, 410 
<fadein/> tag in RealPix, 171 
<fadeout/> tag in RealPix, 172 
file extension list, 595 
fill attribute, 327 
SMIL 1.0 and 2.0 differences, 207 
transition value, 412 
see also timing:fill period 
<fill/> tag in RealPix, 173 
fillDefault attribute, 334 
film-to-video transfer, 88 
fit attribute, 301 
affect on clips, 302 
clip scaling recommendations, 304 
clip source tag, 294 
filling the region, 303 
illustration of effects, 303 
interaction with registration points, 304 
maintaining aspect ratio, 303 
maintaining clip size, 303 
overriding in clip source tag, 303 
with RealPix, 159 
with RealText, 117 
Flash 
advancing scene to scene, 101 
audio 
export, 105 
import, 96 
bandwidth targets, 92 
clip caching, 101 
CPU use, 95 
data spikes, 92 
event sounds, 96 
file size, 94 
frame rate, 95 
Get URL command 


Index 


controlling RealOne Player, 100 
pop-up windows, 383 
sending URL to browser, 100 
Go To command, 101 
groups, 94 
Helix Server requirements, 92 
HTTP GET and POST commands, 104 
key frames, 94 
linear vs. non-linear, 91 
Load Movie command 
restrictions on, 102 
SMIL in place of, 103 
timeline behavior with, 103 
mouse event trapping, 104 
overview, 91 
pausing 
Flash clip, 99 
RealOne Player, 101 
Play command, 99 
Player file export, 105 
pop-up windows 
examples, 384 
links for, 383 
Ram file with, 106 
RealAudio issues 
bandwidth division, 97 
codec tips, 98 
for 28.8 Kbps modems, 97 
for 56 Kbps modems, 98 
RealOne Player requirements, 92 
secure transactions, 104 
seeking 
through presentation, 100 
time format for, 100 
to Flash frame, 100 
SMIL with, 106 
starting 
Flash clip, 99 
RealOne Player, 101 
stopping 
Flash clip, 99 
RealOne Player, 101 
stream synchronization, 96 
symbols, 94 
timeline control, 99 
tuning, 92 
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tweening, 96 bandwidth constraints on, 28 
Web server delivery, 525 stream maximum, 28 
focusInEvent value, 349 stream thinning, 52 
focusOutEvent value, 349 through ISPs, 28 
<font> tag in RealText, 127 Helix Server SDK, 14 
frame rates higher attribute, 263 
Flash, 95 horzRepeat attribute, 409 
RealVideo, 75 hot spots, see hyperlinks 
video capture, 84 <hr> tag in RealText, 137 
from attribute, 426 href attribute, 367 
full-screen mode HTML Help version of this guide, 12 
overview, 34 HTML+Javascript version of this guide, 12 
full-screen playback, 514 HTTP 
compared to RTSP, 505 
G GIF, see images in presentation links, 505 
graphics, see images in SMIL file, 219 
group tags, 245 see also Web server 
groups hyperlinks 
begin and end times, 315 <a> tag, 360 
durations, 319 activation methods, 359 
relationship to timing, 311 actuate attribute, 369 
see also exclusive groups alternate text, 370 
see also parallel groups animating, 426 
see also sequences <area/> tag, 360 


.gz extension, 524 automatic launching, 369 


GZIP encoding, 523 basic Properties, 367 
begin attribute, 361 


coords attribute, 361 
destinationLevel attribute, 382 
end attribute, 361 
external attribute, 372 
fill period activity, 334 
groups and, 359 
hot spots 
circular, 363 
cropping, 366 
image map programs, 366 
mixing pixels with percentages, 365 
overlapping, 360, 366 
percentage decimal values, 365 
polygonal, 364 


H = <head/> tag in RealPix, 158 
height attribute 
<region/> tag, 281 
<root-layout/> tag, 276 
<topLayout> tag, 277 
animating, 423, 425 
clip source tag, 294 
related info pane, 374 
Helix Producer 
overview, 41 
SDK, 14 
see also RealAudio 
see also RealVideo 


Helix Server rectangular, 362 
administration guide, 14 sample coordinates, 366 
administrator, 27 scaling, 365 
advanced features, 28 sizing 
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tips, 365 named windows, 375 

href attribute, 367 opening on a mouse click, 387 

key activation, 368 opening while a clip plays, 387 
case-sensitivity, 368 related info pane, 373 
indicating keys, 369 see also related info pane 
long description, 368 zoomlevel attribute, 384 
overlapping links, 369 see also clip source tags 
usable keys, 368 

long description, 360 I <i> tag in RealText, 137 


media playback state 
bandwidth issues, 376 
controlling, 376 


id attributes 
case-sensitivity, 203 
clip source tags, 210 


nesting, 359 first characters, 203 
nohref attribute, 368 length, 203 


overlapping, 359 

RealPix links, 163 

RealText links, 138 

recommendations, 357 

regions and, 359 

scaling in animated regions, 424 

sendTo attribute, 373 

shape attribute, 361 

sound level adjustments, 382 

sourceLevel attribute, 382 

SourcePlaystate attribute, 376 

streaming media 
linking from Flash, 383 
linking from RealPix, 383 
linking from RealText, 383 
media playback state, 377 
named media windows, 379 
new media windows, 378 


spaces in, 203 
uniqueness, 202 
<image/> tag in RealPix, 165 
images 
caching, 219 
durations, 319, 333 
GIF or PNG transparency override, 227 
in SMIL, 42 
JPEGTRAN utility, 151 
reliable transmission, 212 
slow streaming example, 211 
streaming speed, 210 
supported formats, 42 
see also RealPix 
<imfl> tag in RealPix, 152 
<img/> tag, 209 
inBoundsEvent value, 346 


replacing a clip, 377 inline switching, 441 
SMIL id link, 381 inline text 
SMIL regions, 379 carriage returns, 231 
timeline offsets, 381 clip duration, 231 
tabbing order, 370 data format, 229 
target attribute, 375, 379 escape codes, 230 
timed links, 361 line length, 231 
URLs, 367 region fit, 231 
Web page registration points, 231 
browser pop-up location, 376 scroll bars, 231 
default browser, 373 SMIL tag for, 229 
frame targets, 375 text truncation, 231 
HTML anchors, 376 uses, 229, 231 
media browser pane, 373 interlaced video, 88 
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inverse-telecine filter, 88 

iris wipes, 397 

ISDN bandwidth targets, 47 
ISPs and Helix Server, 28 


Javascript 
overview, 39 
scripting guide, 14 
JPEG, see images 
JPEGTRAN utility, 151 


keystroke activation 
for clip timing, 349 
for hyperlinks, 368 


LAN bandwidth use 
lowering, 48 
maximum, 47 

language choices 
codes, 597 
setting, 443 

laying out presentations 
embedded playback, 501 
with HTML, 502 
with SMIL 

in RealOne Player, 267 
in Web page, 501 
see also regions, 279 

layout examples, 304 

left attribute 
<region/> tag, 281 
<regPoint/> tag, 298 
animating, 423, 425 
clip source tag, 294 

letterbox videos, 305 

<li> tag in RealText, 137 

links 
Ram file 

to Helix Server, 508 

to local files, 508 

to Web server, 508 
Web page 

to Web Server, 504 
see also hyperlinks 
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local files, 29 

logos, 528 

long description, 242 
longdesc attribute, 242 
loss protection, 89 
lower attribute, 263 


manuals, where to find, 13 
matrix wipes, 402 
max attribute, 320 
media browser pane 
Now Playing list, 36 


opening with HTML page hyperlink, 38 


overview, 36 
secondary windows, 37 
supported technologies, 531 
target name in hyperlinks, 38 
URL parameters, 512 
media commerce suite, 532 
media playback pane 
overview, 31 
sizing, 31 
supported content, 31 
with related info pane, 33 
mediaOpacity attribute 
animating, 425 
using, 223 
mediaRepeat attribute, 325 
mediaSize attribute, 471 
mediaTime attribute, 472 
metafile, see Ram file 
MIME types for Web servers, 523 
min attribute, 320 
modem bandwidth targets, 47 
monitor size switching, 452 
MPEG 
converting to RealAudio, 71 
converting to RealVideo, 86 


namespaces 
background on, 204 
declaring but not using, 206 
SMIL 1.0 compatibility, 204 
SMIL 2.0 


customizations, 204 
language profile, 198 
support for in media players, 206 
Netscape Navigator 6 
missing plug-in search, 484 
sample file link problem, 3 
Netscape plug-in, see embedded playback 
network connection speeds, 47 
nohref attribute, 368 
noise filters, 88 
normal play time format 
RealPix, 159 
RealText, 119 
SMIL, 314 
Now Playing list, 36 


OBJECT tag, see embedded playback 
<ol> tag in RealText, 137 

open attribute, 277 

OpenDML, 85 

operating system switching, 450 
outOfBoundsEvent value, 346 
overdubbing preference, 445 


<p> tag in RealText, 136 

<par> tag, 249 

parallel groups 
animations within, 419 
authoring information, 250 
bandwidth issues, 250 
begin and end times, 315 
defining, 249 


delays through slow image streaming, 250 


durations, 319 
fill period 
clip fills, 330 
group default, 334 
group fills, 332 
group inheritance, 335 
transitions, 413 
independent timelines, 251 
normal end point, 250 
region IDs for clips, 249 
switching, 443 
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synchronizing clips 
default synchronization values, 255 
inheriting, 255 
letting clips slip, 252 
locking clip, 252 
overview, 250 
tolerance values, 257 
defaults, 257 
synchronizing groups, 253 
nested group interactions, 256 
with sequences, 246 
see also timing 
password authentication, 28 
pauseDisplay attribute, 264 
pay-per-view, 28 
PDF version of this guide, 12 
peers attribute, 262 
planning a presentation, 27 
plug-ins 
see embedded playback 
see RealOne Player 
PNG, see images 
pop-up windows 
see regions:secondary media windows 
<pos/> tag in RealText, 126 
<pre> tag in RealText, 136 
<prefetch/> tag, 468 
prefetching 
bandwidth, 469 
bits per second, 469 
percentage of available, 470 
bandwidth attribute, 469 
CHTTP, 473 
clipBegin attribute, 473 
dangers, 468 
data download size 
bytes, 471 
playing time, 472 
recommended maximum, 471 
effect on local playback, 467 
examples, 474 
mediaSize attribute, 471 
mediaTime attribute, 472 
overview, 467 
RealAudio and RealVideo, 472 
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RealText, 473 
SureStream, 472 
synchronizing with a group, 468 
testing, 474 
timing attributes, 468 
URLs, 468 
base URL, 473 
dynamic, 473 
when to prefetch, 472 
preroll, 46 
presentation information overview, 235 
priority classes, 261 
paused clip display, 264 
<priorityClass> tag, 261 
protocols 
CHTTP, 219 
RTSP, 505 
publishing tools, see Helix Producer 
push wipes, 405 


QuickTime 
converting to RealAudio, 71 
converting to RealVideo, 86 


.fam extension, 519 
Ram file 
clip playback size, 514 
clipinfo parameter, 517 
comments, 509 
creating manually, 507 
line breaks, 508 
linking 
to Helix Server, 508 
to local files, 508 
to Web server, 508 
overview, 37 
parameter syntax, 510 
RealOne Player start mode, 514 
related info pane URL, 511 
replacing with Ramgen, 519 
see also Ramgen 
within a SMIL file, 213 
Ramgen 
options 
altplay, 522 


combining, 522 
embed, 521 
using, 519 
readIndex attribute, 243 
RealAudio 
audio quality and bandwidth, 59 
bandwidth characteristics, 60 
codecs 
lossy nature, 59 
mono music, 62 
older, 64 
sampling rates, 61 
stereo music, 63 
surround sound, 64 
voice, 61 
converting to other formats, 69 
encoded information, 235 
encoding instructions, 71 
encoding tips, 71 
Flash 
audio export, 105 
soundtrack, 96 
prefetching data, 472 
RealVideo soundtracks, 73 
sound quality, 59 
streaming rates 
multimedia, 72 
standard, 60 
streaming steps, 65 
Web server playback, 524 
with other clips, 60 
see also audio 
RealFlash, see Flash 
RealGuide, 527 
RealOne Player 
autoupdate, 43 
backward compatibility, 44 
clip compatibility, 43 
copyright protection 
with Helix Server, 45 
with Web server, 524 
doubling clip size, 514 
download logo, 528 
embedding in Web page 
see embedded playback 


full-screen playback, 514 
Javascript guide, 14 
language choices 

codes, 597 

setting, 443 
plug-in download, 43 
RealVideo 8 codec support, 79 
RealVideo 9 codec support, 79 
SDK, 14 
SMIL source view, 206 
theater mode, 514 
toolbar mode, 514 
VBScript guide, 14 
version testing, 453 

Real Pix 

absolute URLs, 166 
animated GIF control, 175 
aspect ratios 

all images, 163 

specific images, 170 
background color, 161 
backwards compatibility, 148 
bandwidth management, 154 
broadcasting, 153 
color fill, 173 
copyright protection, 149 
crossfading images, 172 
destination rectangle definition, 180 
duration 

presentation, 160 

specific effects, 168 
examples 

playable clips, 147 

step-by-step walkthrough, 184 
fades 

from color, 171 

to color, 172 
frame rate maximum 

all effects, 164 

specific images, 170 
header, 158 
image 

caching, 149 

cropping, 181 

display size, 159 

distortion, 163 
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file size attribute, 166 
formats, 150 
handles, 165 
mime type attribute, 167 
paths, 166 
placement, 179 
resizing, 179 
selection, 169 
shrinking, 182 
streaming times, 156 
JPEGTRAN utility, 151 
overview, 147 
panning across an image, 178 
pop-up windows 
links for, 383 
preroll 
calculating, 154 
lengthening, 162 
lowering, 157 
masking, 157 
server stream requirements, 148 
SMIL transition effects comparison, 149 
source rectangle definition, 180 
start time, 168 
streaming bit rate, 161 
syntax 
rules, 153 
structure, 152 
through RealSlideshow, 43 
time format, 159 
timeline 
creation, 168 
management, 152 
troubleshooting, 160 
title, author, and copyright, 161 
transparency, 151 
view changes, 176 
Web page links 
all images, 163 
specific images, 169 
Web server delivery, 166, 525 
width and height, 159 
wipe effects 
creating, 174 
direction of wipe, 175 
push and slide effects, 175 
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zooming in or out, 177 features, 111 
RealSlideshow, 43 file 
RealText extension, 111 
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accented languages, 129 
background color, 116 
bandwidth characteristics, 113 
bolding text, 137 
broadcasting, 114 
captions, 448 
examples, 460 
centering text, 136 
character sets 
big5, 130 
default, 128 
gb2312, 130 
iso-2022-kr, 130 
RealText version for, 120 
iso-8859-1, 129 
mac-roman, 129 
coded characters, 141 
RealText version for, 120 
specifying, 128 
us-ascil, 129 
x-sjis, 130 
Chinese character set, 130 
coded characters, 140 


mac-roman character set, 141 


colors 
hexadecimal values, 134 
text, 134 
text background, 134 
window background, 134 
comments, 113 
crawl rate, 121 
description, 43 
duration 
in SMIL presentation, 118 
of clip, 118 
troubleshooting, 119 
erasing text, 125 
examples, 142 
generic window, 142 
scrollingnews window, 144 
teleprompter window, 145 
tickertape window, 143 
extra spaces, 122 


names, 113 
structure, 112 

fonts 
Asian languages, 132 
colors, 133 


English and European languages, 130 


text size, 133 
freezing text, 125 
guaranteed text delivery, 127 
horizontal positioning, 126 
horizontal rules, 137 
horizontal text movement, 121 
hyperlinks 

color, 121 

commands, 140 

HTML page, 138 

mail, 138 

streaming presentation, 138 

underlining, 121 
italicizing text, 137 
Kanji character set, 130 
Korean character set, 130 
language support, 112 
line breaks, 136 
lists, 137 
looping text, 122 
Macintosh text entry, 129 
overview, 111 
paragraph tags, 136 
pop-up windows 

examples, 384 

links for, 383 
prefetching, 473 
preformatted text, 136 
RealOne Player command links 

pausing, 140 

playing, 140 

seeking, 140 
scroll rate, 121 
SMIL 


combining with other clips, 113 


fit attribute, 117 
striking through text, 137 


subtitles 
erasing each line, 125 
syntax rules, 112 
text size, 133 
timing commands 
begin, 123 
end, 124 
with scrolling or crawling text, 125 
transparency 
text backgrounds, 135 
window background, 117, 223 
underlining text, 137 
version numbers, 120 
vertical positioning, 126 
vertical text movement, 121 
Web server delivery, 525 
window size, 116 
window types 
default attribute values, 116 
generic, 115 
example, 142 
marquee, 116 
scrollingnews, 115 
example, 144 
teleprompter, 115 
example, 145 
tickertape, 116 
colors, 126 
example, 143 
text positioning, 126 
word wrap, 121 


RealVideo 


artifacts 

causes of, 76 

reducing, 88 
bandwidth characteristics, 73 
codecs 

lossy nature, 75 

RealVideo 8, 79 

RealVideo 9, 79 

RealVideo G2, 80 

RealVideo G2 with SVT, 80 
compressed input, 84 
converting to other formats, 84 
dimensions 

different sizes for different bit rates, 78 
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recommended sizes, 77 
switching between, 457 
encoded information, 235 
encoding instructions, 87 
encoding tips, 86 
error correction, 89 
filters 
de-interlace, 88 
inverse-telecine, 88 
noise, 88 
resize, 88 
frame rates 
factors that affect, 75 
lowering for slow CPUs, 80 
overview, 75 
variable nature, 75 
prefetching data, 472 
production steps, 80 
quality guide, 77 
Scalable Video Technology, 80 
soundtrack 
bandwidth ratio, 87 
RealAudio for, 73 
streaming rates 
modifying, 87 
standard, 74 
two-pass encoding, 89 
variable bit rate encoding, 89 
visual clarity 
factors that affect, 77 
overview, 76 
see also video 
rebuffering, 46 
<ref/> tag, 209 
regAlign attribute, 296 
region attribute in clip source tags, 287 
regionName attribute 
animating, 423 
defining, 280 
regions 
assigning to clips, 287 
audio clips, 287 
audio volume control, 292 
background colors, 290 
changing in clip tag, 291 
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inheriting, 290 
transparency 
partial, 290 
until clip plays, 290 
bottom attribute, 281 
clip scaling, 301 
considerations for creating, 274 
cropped at window boundaries, 287 
defining, 279 
examples 
centering a video, 304 
four offsets defined, 283 
letterbox clip, 305 
one offset defined, 285 
overlapping regions, 286, 288 
side-by-side clips, 306 
size and two offsets defined, 284 
two offsets defined, 285 
width and height defined, 282 
fit attribute, 301 
height attribute, 281 
id attribute, 280 
layout tips, 272 
left attribute, 281 
multiple region playback, 307 
multiple regions for one clip, 280 
name attribute, 280 
overlapping, 288 
overview, 267, 268 
percentage values, 282 
positions, 281 
resizing control, 279 
reusing, 288 
right attribute, 281 
root-layout 
defining, 276 
overview, 267 
sizing 
considerations, 273 
double-screen mode, 273 
example, 273 
full-screen mode, 273 
RealOne Player controls, 273 
secondary media windows, 269 
close attribute, 277 
considerations for using, 273 
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defining, 277 
example, 307 
full-screen mode, 278 
hyperlinked window comparison, 270 
open attribute, 277 
pop-up location, 278 
viewer interaction, 278 
sizes 
pixels and percentages, 281 
decimal percentages, 287 
mixing, 287 
resize behavior, 287 
setting, 281 
soundLevel attribute, 292 
stacking order, 288 
subregions 
attribute inheritance, 293 
background colors, 293 
considerations for creating, 274 
defining, 292 
nesting, 293 
overview, 268 
registration point comparison, 275 
single-use, 294 
z-index attribute, 293 
tag summary, 275 
top attribute, 281 
transparency, 290 
width attribute, 281 
z-index attribute, 288 


registration points 


alignment values, 296 
clip source tags, 296 
common values 

in clip source tags, 297 

in <regPoint/> tags, 299 
considerations for creating, 274 
default positioning, 301 
defining in layout, 298 
fit attribute interaction, 301 
ID values, 300 
methods of creating, 295 
misalignment problems, 297, 301 
overview, 271 
pixels and percentages 

defining, 298 


mixing, 301 
recommendations, 301 
positioning, 298 
relationship to regions, 300 
reusing in clips, 301 
subregion comparison, 275 
regPoint attribute, 296, 299 
<regPoint/> tag, 298 
see also registration points 
related info pane 
background color, 375 
content caching, 36 
defining, 373 
frames, 35 
linking from browser pane, 375 
linking to browser pane, 373 
opening at the presentation start, 374 
overview, 34 
recommended use, 375 
scroll bars, 35 
sizing, 374 
browser pane width override, 35 
defaults, 35 
media pane height override, 35 
overview, 35 
persistence, 35, 36 
recommendations, 375 
specifying in Ram file 
display time, 512 
height and width, 511 
media background color, 512 
URL, 511 
supported technologies, 531 
URL parameters, 512 
with media playback pane, 33 
relative links 
in Ram file, 507 
in SMIL, 217 
reliable transmission, 212 
repeat(n) value, 344 
repeatCount attribute, 323 
repeatDur attribute, 323 
repeatEvent value, 344 
repeating clips, see timing:repeating clips 
<required> tag in RealText, 127 
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resize filters, 88 
resizeBehavior attribute, 279 
restart attribute, 352 
restartDefault attribute, 353 
right attribute, 281 
<region/> tag, 281 
<regPoint/> tag, 298 
animating, 423, 425 
clip source tag, 294 
.rmvb extension, 89 
rn: prefix, 203 
rollover events, 346 
<root-layout/> tag, 276 
see also regions 
.'pm extension, 519 
RTSP 
compared to HTTP, 505 
in presentation links, 505 
in SMIL file, 218 
overview, 505 
port number, 218 


<s> tag in RealText, 137 

sample files, 12 

sampling rates, 61 

Scalable Video Technology (SVT), 80 
scaling clips in regions, 301 

scroll bars in SMIL regions, 302 


secondary media windows, see regions:sec- 


ondary media windows 
secure transactions with Flash, 104 
sendTo attribute 
namespace declaration, 373 
with <a> tags, 373 
<seq> tag, 247 
sequences 
animations within, 419 
authoring information, 248 
begin and end times, 315 
defining, 247 
durations, 319 
fill period 
clip fills, 329 
group default, 334 
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group fills, 332 
group inheritance, 335 
transitions, 412 
Next Clip command, 248 
seeking through, 248 
single presentation vs. multiple clips, 248 
switching, 443 
with parallel groups, 246 
<set/> tag 
compared to <animate/>, 418 
using, 436 
shape attribute, 361 
shielded cables, 68 
Shockwave Flash, see Flash 
show attribute, 377 
slide wipes, 405 
slideshows, see RealPix 
SMIL 1.0 
RealPlayer support, 193 
SMIL 2.0 feature inclusion, 454 
updating to SMIL 2.0, 207 
SMIL 2.0 
advantages of, 192 
attribute changes from SMIL 1.0, 207 
attribute format, 200 
bandwidth characteristics, 49 
binary tags, 201 
body section, 198 
camel case values, 200 
case-sensitivity, 200 
closing tag, 198 
coded characters, 237 
comments, 202 
customized attributes, 203 
extensions, 203 
functional changes from SMIL 1.0, 206 
general rules, 197 
header, 198 
coded characters, 237 
hyphenated attributes, 200 
id attributes, 202 
indentation, 202 
language codes, 597 
layout, see regions 
links, see hyperlinks 


major features, 192 

media player interoperability, 196 

modules, 194 

namespace, 198 

overview, 191 

prefixes, 203 

presentation information, 240 

profiles, 195 

proprietary datatypes with, 197 

quotation marks for values, 200 

RealOne Player compliance, 195 

slideshows, 148 

SMIL 1.0 compatibility, 454 

.smil extension, 198 

SMIL file as a clip, 214 

source file viewing, 206 

specification, 191 

syntax errors, 201 

tag format, 200 

text display, 43 

timing, see timing 

title, author, copyright, 240 

unary tags, 201 

viewing SMIL source, 206 

with Web server playback, 525 
SMIL animation 

accumulate attribute, 432 

additive attribute, 432 

attributeName attribute, 422 

audio levels, 424 

begin times, 420 

by attribute, 427 

calcMode attribute, 429 

clip stacking order, 424 

clips, 425 

colors, 434 

discrete values, 429 

durations, 420 

examples, 417 

flowing from point to point, 430 

freezing, 420 

from attribute, 426 

hyperlinks 

changing coords values, 426 
scaling in animated regions, 424 
in clip tags, 419 


in parallel groups, 419 
in sequences, 419 
incremental, 432 
jumping from point to point, 429 
linear values, 430 
motion, 435 
multiple animation points, 428 
overview, 417 
paced values, 430 
regions, 423 
repeating, 420 
repeating and growing, 432 
root-layout, 422 
selecting attribute to animate, 422 
setting values instantly, 436 
simultaneous, 421 
start and stop values, 426 
tags, 418 
targetElement attribute, 422 
time manipulations, 437 
timing attributes, 420 
to attribute, 426 
transparency, 425 
values attribute, 428 
.smil extension, 198 
SMPTE code, 394 
SND conversion to RealAudio, 71 
software development kits (SDKs), 14 
soundLevel attribute 
animating, 424 
using, 292 
sourceLevel attribute, 382 
sourcePlaystate attribute, 376, 377 
special effects 
see SMIL animation 
see transition effects 
stream thinning, 52 
streaming 
speeds for network connections, 47 
versus downloading, 505 
Web server, 504 
subregions, see regions 
subtitles 
compared to captions, 460 
example, 458 
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preference for, 445 
through RealText, 445 
transparent background, 117 
SureStream 
backward compatibility, 45 
overview, 50 
RealAudio codecs, 61 
switching, 447 
SVG animation, 42 
s-video, 84 
<switch> tag, 439 
switching 
audio descriptions, 448 
bandwidth, 446 
captions, 448 
example, 460 
color depth, 452 
component testing, 453 
CPU type, 449 
default option 
adding, 440 
filler clip, 443 
when not to use, 443 
examples 
captions, 460 
different video dimensions, 457 
multiple attributes, 456 
group switching, 443 
hyperlink inclusion, 443 
inline, 441 
language choices 
codes, 444 
examples, 458 
explanation, 443 
layouts, 443 
monitor size, 452 
multiple attributes 
example, 456 
nested, 443 
example, 457 
operating system, 450 
overview, 51, 439 
subtitles or overdubbing, 445 
test attributes 
list of, 442 
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multiple attributes, 443 <textstream/> tag, 210 


version testing, 453 theater mode for RealOne Player, 514 
versus interactive choices, 439 


syncBehavior attribute, 251 
syncBehaviorDefault attribute, 255 


time manipulations, 437 
<time/> tag in RealText, 123 
Timecast, see RealGuide 


synchronizing clips in parallel groups, 250 timing 

syncTolerance attribute, 257 advanced, 337 
syncToleranceDefault attribute, 257 element repeat, 344 
systemAudioDesc attribute, 448 element start or stop, 342 
systemBitrate attribute, 446 interactive events, 338 
systemCaptions attribute, 448 keyboard events, 349 


media markers, 352 

min and max values, 320 
mouse event, 346 

negative offset values, 341 
positive offset values, 339 
scheduled events, 338 
secondary window events, 351 


systemComponent attribute, 453 
systemCPU attribute, 449 
systemLanguage attribute, 443 
systemOperating system attribute, 450 
systemOverdubOrSubtitle attribute, 445 
systemRequired attribute, 453 


system-required attribute, 454 syntax, 337 
systemScreenDepth attribute, 452 wallclock timing, 352 
systemScreenSize attribute, 452 animated GIF modification, 325 
basic, 311 
T _ tabindex attribute, 370 begin attribute, 315 


clipBegin attribute, 316 
clipEnd attribute, 316 
delaying clip playback, 315 
dur attribute, 317 

: : compared to end, 317 
testing presentations, 526 durations, 317 

text, 43 groups, 319 

text clips images, 319 


target attribute, 375, 379 

target name for media browser pane, 38 
targetElement attribute, 422 

technical support, 14 


durations, 228 
escape codes, 228 
font use, 228 
line length, 229 
region fit, 229 
registration points, 229 
returns, tabs, and spaces, 228 
scroll bars, 229 
SMIL tag for, 228 
text truncation, 229 
see also inline text 
see also RealText 
text streaming, see RealText 
<text/> tag, 210 
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indefinite, 318 

normal clip length, 318 
end attribute, 315 

compared to dur, 317 
exclusive groups, 259 

begin and end times, 315 

durations, 319 

group endpoint 


last clip, 320 
fill attribute, 327 
fill period, 327 


automatic fill, 328 
default fills, 334 
exclusive group clips, 330 


groups, 332 
indefinitely visible clip, 330 
parallel group clips, 330 
sequential clips, 329 
SMIL 1.0 and 2.0 differences, 207 
summary, 331 
keyboard events 
case-sensitivity, 350 
indicating keys, 350 
long description, 350 
usable keys, 350 
mediaRepeat attribute, 325 
multiple time values, 342 
overview, 311 
parallel groups 
begin and end times, 315 
durations, 319 
group endpoint 
first clip, 321 
last clip, 320 
specific clip, 321 
partial clip play, 327 
relationship to groups, 311 
repeatCount attribute, 323 
repeatDur attribute, 323 
repeating clips 
bandwidth management, 325 
indefinite number of times, 324 
repeating cycle length, 324 
server streams used, 326 
specific amount of time, 323 
specific number of times, 323 
total playing time, 324 
restarting elements, 352 
group defaults, 353 
sequences 
begin and end times, 315 
durations, 319 
tenths of seconds display, 313 
values 
normal play time format, 314 
shorthand, 313 
Web server delivery issues, 526 
timing a presentation 
internal timelines, 53 
timeline management, 55 
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timeline synchronization, 52 
variable timelines, 53 
with multiple clips, 53 
title attribute 
in Ram file, 516, 517 
in RealPix, 161 
in SMIL, 238 
<tl> tag in RealText, 126 
to attribute, 426 
toolbar mode for RealOne Player, 514 
top attribute 
<region/> tag, 281 
<regPoint/> tag, 298 
animating, 424, 425 
clip source tag, 294 
<topLayout/> tag, 277 
see also regions 
topLayoutCloseEvent value, 351 
topLayoutOpenEvent value, 351 
transIn attribute, 411 
transition effects 
animation comparison, 392 
assigning to clips, 411 
audio impact, 392 
borderColor attribute, 410 
borders 
blends, 410 
colors, 410 
pixel width, 410 
borderWidth attribute, 410 
clock wipes, 399 
direction attribute, 407 
dur attribute, 407 
duration 
changing, 407 
default, 392 
edge wipes, 394 
endProgress attribute, 408 
examples 
color fade, 414 
crossfade, 415 
fadeColor attribute, 410 
fades, 405 
colors, 410 
fill attribute 
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parallel groups, 413 
sequences, 412 
horzRepeat attribute, 409 
id attribute, 394 
instantaneous effects, 409 
iris wipes, 397 
layout considerations, 392 
matrix wipes, 402 
multiple clips, 393 
overview, 391 
partial effects 
defining, 408 
fill attribute, 409 
push wipes, 405 
repeating, 409 
slide wipes, 405 
SMPTE code, 394 
startProgress attribute, 408 
subtype attribute, 394 
tag summary, 393 
timeline impact, 392 
transIn attribute, 411 
transOut attribute, 411 
type attribute, 394 
vertRepeat attribute, 409 
<transition/> tag, 393 
see also transition effects 
transOut attribute, 411 
transparency 
clips 
color for transparency, 227 


for a specific opaque color, 224 


for all opaque colors, 223 
for background color, 223 
supported clip types, 291 
region backgrounds 
full, 290 
partial, 290 
<tu> tag in RealText, 126 
two-pass encoding, 89 


<u> tag in RealText, 137 
<ul> tag in RealText, 137 
URL events encoded in clips, 37 


values attribute, 428 
variable bit rate encoding, 89 
VBScript with RealOne Player, 14 
vertRepeat attribute, 409 
VHS format, 82 
video 
see also RealVideo 
capture 
cards, 40 
disk space, 85 
file size limit, 85 
formats, 84 
frame rates, 84 
requirements, 85 
screen size, 85 
editing programs, 40 
interlaced, 88 
lighting, 83 
minimizing movement, 83 
motion resolution, 83 
production tools, 40 
recording tips, 82 
source formats, 82 
staging shots, 83 
streaming steps, 80 
s-video, 84 
24-bit depth, 84 
Video for Windows, 84 
<video/> tag, 210 
<viewchange/> tag in RealPix, 176 
visual quality of RealVideo, 76 
visualizations, 33 
volume 


control for embedded playback, 492 
fading through SMIL animations, 424 


live broadcasts, 68 
SMIL region control, 305 


wallclocks for broadcasts, 352 
WAV conversion to RealAudio, 71 
Web page playback, 479 
Web pages 
see also media browser pane 
see also related info pane 


Web server 
GZIP encoding, 523 
MIME type configuration, 523 
playback 
instructions, 504 
limitations, 524 
unsecure clips, 524 
wide screen video display, 305 
width attribute 
<region/> tag, 281 
<root-layout/> tag, 276 
<topLayout> tag, 277 
animating, 423, 424, 426 
clip source tag, 294 
related info pane, 374 
<window> tag in RealText, 112 
<wipe/> tag in RealPix, 174 
wipes, see transition effects 


World Wide Web Consortium (W3C), 191 


XML namespace, 198 
xmlns attribute, 198 


z-index attribute, 288 
animating, 424, 426 
clip source tag, 294 
default value, 289 
duplicate values, 289 
negative integers, 289 
recommended values, 289 
<root-layout/> tag, 289 
subregions, 293 

zoomlevel attribute, 384 
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